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PREFACE 


MANUAL OBJECTIVES 


The RSX-11M System Generation and Installation Guide provides you with 
the information necessary to generate an RSX-11M operating system. 
Included in this manual are descriptions of the interactive system 
generation procedure called SYSGEN, detailed information on how to use 
the distribution media to generate your RSX-11M system, and an 
explanation of each of the SYSGEN questions. 


INTENDED AUDIENCE 


This manual is intended for the system manager who is responsible for 
generating and maintaining an RSX-11M operating system. Most of the 
information in this manual requires familiarity with an RSX-11M 
operating system and its component tasks. 


STRUCTURE OF THIS MANUAL 


Chapter 1 introduces the RSX-11M system generation and installation 
process. 


Chapter 2 describes the RSX-11M distribution media, including 
step-by-step instructions for copying the media in your distribution 
kit to your target system disk. The chapter also includes an 
introduction to the various operating environments that can serve as a 
host to RSX-11M system generation. Finally, the chapter describes the 
procedures you use to apply an Update package to your RSX-11M 


operating system. 

Chapter 3 discusses the RSX-11M system generation procedure. It 
describes the structure of SYSGEN as well as specific SYSGEN options 
that make it easier to generate your system. It contains information 
that is vital to performing a successful system generation. Read it 
carefully before you begin your system generation. 

Chapter 4 explains each of the questions in SYSGEN Phase I. 

Chapter 5 explains each of the questions in SYSGEN Phase II. 


Chapter 6 describes the various procedures that you should follow once 
you have generated your system. 


Chapter 7 explains each of the questions in SYSGEN Phase III. 


Chapter 8 explains the various system error messages that may be 
generated during system generation. 
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Appendix A defines the saved answer symbols that SYSGEN creates based 
on your responses to questions. 


Appendix B provides information for hardware bootstrapping your PDP-11 
processor. 


Appendix cC lists devices and associated device mnemonics and 
controllers. 


Appendix D lists the tasks and system functions that impact’ the 
dynamic storage region (DSR), which is also called the "system pool." 


Appendix E contains detailed information on floating control and 
status register (CSR) and vector addresses, and defines the DIGITAL 
standard hardware configuration algorithm. 


Appendix F lists the directory contents of each volume in the 
distribution kits. 


ASSOCIATED DOCUMENTS 


The following documents provide more detailed descriptions of some of 
the system components that are discussed in this manual: 


RSX-11M/M-PLUS System Management Guide 

RSX-11M/M-PLUS and Micro/RSX Executive Reference Manual 
RSX-11M/M-PLUS MCR Operations Manual 

RSX-1L1IM/M-PLUS and Micro/RSX I/O Drivers Reference Manual 


SVN 


RSX-11M/M-PLUS and Micro/RSX Task Builder Manual 


re ET EN, 


CONVENTIONS 
This manual uses the following conventions: 


Convention Meaning 


CTRL/a) A symbol indicating that the CTRL key must be held down 
while another key is pressed. For example, means 


that you hold down the CTRL key while pressing Z. 


XXX A l- to 3-character key symbol. For example, RET, 
indicates the RETURN key, indicates the LINE FEED 
key, and indicates the ESC key. 


MCR> The explicit Monitor Console Routine (MCR) prompt. MCR is 
one of two RSX-11M command line interpreters. The 
examples in this manual show MCR commands only. 


> The implicit prompt that the system displays to indicate 
that it is ready to accept input from a terminal. 

1) A reverse number (a white number printed in a black 
circle) which is used to key a specific part of an example 
to a numbered list that follows the example. The 


corresponding reverse number in the list explains that 
part of the example. 


Red Ink The color of ink used to show uSser-entered commands in 
examples. 


SUMMARY OF TECHNICAL CHANGES 


The RSX-11M System Generation and Installation Guide has been revised 
to reflect the following additions and changes to the system 
generation procedure for RSX-1L1M Version 4.2: 


The distribution kits that contain the files for generating 
the new system image have undergone several changes: 


For stand-alone system generations, the default CSR address 
that the Stand-Alone Configuration and Disk Sizing Program 
(CNF) expects for MT:-type devices has been changed. Also, 
for the TKS50 distribution kit (which includes BRUSYS), 
default values have been added for MU:-type devices. 


The RLO1l and RLO2 distribution kits have been changed. The 
RLOl kit now consists of seven disks rather than six. The 
EXCPRV backup set has been split into two sets, EXCPRV and 
PRVBLD. EXCPRV contains the files for assembling the 
Executive, device drivers, and some MCR modules during 
Phase I of SYSGEN. PRVBLD contains the files for building 
the Executive, device drivers, libraries, and privileged 
tasks during Phase II of SYSGEN. 


The RLO2 distribution kit contains only five disks because 
the PRVBLD and RLUTIL backup sets are on the disk labeled 
PRVBLD, and the MCRSRC and HLPDCL backup sets are on the 
disk labeled MCRSRC. 


A new distribution kit is available with this version of 


the operating system. The new kit consists of two TK50 
Magnetic tape cartridges that are driven by a TK50 
streaming tape drive. One tape contains the new system 


files; the second tape contains BRUSYS, which is an RSX-115S 
system dedicated to stand-alone copying of the distribution 
kit. 


The procedure for copying the baseline system from magnetic 
tape distribution kits to disk has been simplified. The 
baseline system now includes an Indirect command procedure 
named TAPEKIT.CMD that guides you through the copying 
process. 


The RSX-11M operating system now supports the following new 
features: 


Asynchronous Terminal Interfaces: The YV drive for the 
DHV11l and DHU11 multiplexers. The DHVll is a Q-BUS 
multiplexer that handles eight lines at speeds up to 19.2K 
baud with full modem control. The DHU11 is the UNIBUS 
equivalent of the DHV11. It handles up to 16 lines’ with 
full modem control. You must select the full-duplex 
terminal driver during SYSGEN if you want support for the 
DHV11 or DHU1I1. Also, RSX-11M now supports the YZ drive 
for the DZQ11 Q-BUS multiplexer. 
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SUMMARY OF TECHNICAL CHANGES 


- Terminal Characteristics: RSX-11M now supports additional 
terminal characteristics if you select support for the 
full~duplex terminal driver in the Terminal Driver Options 
Section of Phase I of SYSGEN. The additional terminal 
characteristics include parity generation and checking, 
advanced video and editing options, ANSI-standard and 
DIGITAL-specific escape sequences, ReGIS graphics, and 
block-mode transmission. 


- Network Communications Driver: The DEUNA driver for the XE 
UNIBUS Ethernet communications device. 


- DU devices: 


RD52 fixed-media disks 
RD53 fixed-media disks 


~- MU devices: 


TK50 magnetic tape cartridge 
MU:-type devices as Crash Dump Analyzer memory dump 
devices 


- Controllers: 


RUX50 UNIBUS controller for the RxX50 disk drive 
KDA50-Q controller for RA60 and RA80/RA81 disk drives 
RQDX2 and RQDX3 controllers for RD and RX disk drives 
Q-BUS controller for the TK50 cartridge tape drive 


- Printers: 


LNO3 

LQPO2 
LQPO3 
LA100 
LA210 


- Terminals: 
VT200 series 


- Processors: The Jll-series of processors, which consists 
of the following processors: 


LSI-11/73 
MicroPDP-11/23 
MicroPDP-11/73 
MicroPDP-11/83 
PDP-11/84 


Note that, due to hardware restrictions, RSX-LIM may not 
work properly with most configurations built around the 
LSI-11/73 processor module. 


SYSGEN no longer supports UETP, the User Environment Test 
Package 


SYSGEN no longer automatically supports the IP1l Industrial 
Control Subsystem. The IP11 is now a layered product with its 
own installation process; you can select support for it in the 
System Options Section of Phase I of SYSGEN 
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SUMMARY OF TECHNICAL CHANGES 


Several questions have been modified or added to the SYSGEN 
dialogue: 


- In the Setup Sections of Phases I and II, if you are using 
an RLOl or RLO2 distribution kit and doing a PREPGEN, 
SYSGEN asks where you want the assembly and _ task-build 
files to be located. You can select the default user 
device or the null device; this saves space on _ the 
distribution disks. 


- If you have an RLO1l or RLO2 distribution kit and you are 
chaining from Phase I to Phase II, in the Setup Section of 
Phase I SYSGEN asks you to specify the device on which the 
PRVBLD disk will be mounted. If you are not chaining from 
Phase I to Phase II, SYSGEN asks you to specify the device 
in the Setup Section of Phase II. 


- In the Executive Options Section of Phase I, if you select 
Support for DECnet-11M, SYSGEN asks if you want to include 
Network Command Terminal (NCT) support. NCT support 
enhances’ the full-duplex terminal driver by adding support 
for modem hangup and out-of-band character ASTs, switch 
characters, and extended I/0. 


- In the System Options Section of Phase I, SYSGEN asks if 
you want to include support for the IP11 Industrial Control 
Subsystem. The IP11 is a combined software and hardware 
subsystem that controls and monitors industrial processes. 
If you do select support for the IP11, SYSGEN then asks if 
you also want IP11 power-fail support. 


- In the Peripheral Options Section of Phase I, the prompt 
for DU:-type devices has been changed. Instead of 
specifying a drive, you now specify the interrupt vector 
address, the CSR address, and the number of disk drives for 
each DU controller. 


The following documentation has been added to this manual: 


- The installation procedure for applying software updates to 
the operating system. 


- The instructions for performing an RSX-11M system 
generation on a VAX host computer running in VAX-11l RSX 
compatibility mode. 


The following errors occurred in the previous version (Version 
4.1) of this manual and have been corrected in this version: 


- The references to an RC25 Disk Kit and to an RC25-specific 
Big Disk Magnetic Tape Kit were incorrect. Support for 
system generations targeted to RC25 system disks is 
provided in the magnetic tape distribution kit. 


- The reference to an RPO7 Big Disk Magnetic Tape Kit was 
incorrect. RSX-11M does not support a system generation 
targeted to an RPO7 disk. 


- The reference to Record Management Services’ (RMS) in 
Question 3 of the Executive Options Section of SYSGEN Phase 
I was incorrect and has been’ removed. The Files-ll ACP 
(FCP) supports file sharing and placement control, so 
SYSGEN asks this question if your system includes the FCP, 
regardless of whether your system also includes RMS. 
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CHAPTER 1 


INTRODUCTION 


The RSX-11M system generation procedure  (SYSGEN) offers the 
flexibility, through selection of specific hardware and software 
options, to produce an RSX-11M system tailored specifically to the 
requirements of a given user environment. 


1.1 WHO IS QUALIFIED TO GENERATE AN RSX-11M SYSTEM? 


Generating RSX-11M requires a fairly sophisticated understanding of 
the operating system. If you have never generated an RSX-11M system, 
you may find the system generation procedure overwhelming. There is a 
lot to know and decide. For example, when selecting SYSGEN options, 
you should be familiar with the trade-offs between memory and _ pool 
(pool and other terms are defined in Section 1.6). Some information 
concerning the amount of memory used by specific options is present in 
this manual. However, because hardware and software options can be 
combined in so many different ways, it is impossible to prescribe a 
simple formula to satisfy any given situation. Therefore, the task of 
generating an RSX-11M system is generally reserved for system 
Managers, system programmers, and that general class of users with 
sufficient understanding of the operating system to make the necessary 
judgments. 


1.2 SYSTEM GENERATION MINIMUM REQUIREMENTS 


In order for you to perform an RSX-11M Version 4.2 SYSGEN, your host 
system has to conform to two SYSGEN minimum requirements: 


e Your host system must be mapped. That is, your host system 
must support memory management hardware. 


@e Your host system must have at least 64K words of memory. 


1.3 PLANNING AHEAD 


Before beginning the system generation procedure, you should spend 
some time planning for it. Read through the manual (in particular, 
Chapters 3 and 4) to familiarize yourself With the options you want. 
Be sure that the options you select are compatible and that they make 
sense, and make sure that your hardware supports adequate memory to 
accommodate the operating system you generate. 


Careful planning before you generate your system allows you to _ go 
through the procedure more quickly and easily. 
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Calculations for things such as disk swapping intervals, round-robin 
scheduling intervals, and Swapping priorities require some 
experimenting with the system. If you are generating an RSX-11M 
system for the first time, you may find such calculations difficult to 
make. However, each option comes with a default response that you may 
select (see Chapter 3 for further explanation). Selecting the default 
response allows you to postpone or avoid calculations such as_ those 
mentioned above until it can be determined that the defaults are 
inappropriate for your system. 


For example, you should determine the amount of pool space required 
for your system. Without enough pool, the system response time may be 
slow; with too much pool, you may be wasting valuable memory. 
(Appendix D may help you make those calculations.) By default, SYSGEN 
allocates the maximum amount of pool space available to a mapped 
system after you have selected all the hardware and software options. 
Therefore, you may decide to let SYSGEN calculate your pool size and 
wait until you have time to experiment with your new system before 
making any adjustments. 


1.4 EXPERIMENT WITH YOUR NEW SYSTEM 


The first system you generate may not be optimal for your specific 


needs. Experiment with it to see how it performs. You may find it 
necessary to make some adjustments by adding memory or _ reducing 
options. All of this can be done gradually as you become more 


familiar with your system and understand how various system features 
affect one another. 


1.5 EASE-OF-USE FEATURES 


Some RSX-11M users may want to generate their system as quickly and 
easily as possible and attend to system tuning adjustments afterward. 
The RSX-11M Version 4.2 system generation procedure contains’ two 
options that can ease your involvement in the system generation 
procedure and minimize the number of questions you must answer. 


e The Autoconfigure option automatically determines your 
hardware configuration, and can eliminate the need to answer 
most or all of the SYSGEN questions concerning your target 
configuration and peripheral devices. 


e The Standard Function System option produces a mapped RSX-11M 
operating system with the maximum number of software options, 
including support for layered products. 


Further information on the Standard Function System and Autoconfigure 
can be found in Chapters 3 and 4. 


1.6 OVERVIEW OF SYSGEN 


There are three phases to SYSGEN. Phase I requires you to select’ the 
hardware and software options for your target system. That 
information is then used to assemble the Executive, device drivers, 
and other parts of the system. 


Phase II is dedicated to task building, or linking, your Executive, 
device drivers, privileged and system tasks, and creating a system 
image file. 
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Phase III is dedicated to task building selected privileged and 
nonprivileged tasks. 


SYSGEN questions appear on your terminal based upon how you answer the 


preceding SYSGEN questions. They do not appear in strict numeric 
order. 


Also, the three phases of SYSGEN are not completely independent from 
one another. For example, although you may invoke Phase III of SYSGEN 
without having to go through an entire system generation, you cannot 
invoke Phase II without having gone through Phase I. Phase II 
requires input created during Phase I. Read Chapter 3 for more 
information on the structure and concepts of SYSGEN. 


1.7 SYSGEN TERMINOLOGY 


This section defines some terms used in this manual. The purpose of 
defining these terms here is to familiarize you with them before you 
begin generating your RSX-11M system. For more information on a given 
term, consult the RSX-11M/RSX-11S Information Directory and Master 
Index. 


Executive 


The Executive is the software core, or kernel, of the RSX-11M 


operating system. It is responsible for controlling such 
activities as resource allocation, multiuser protection, and 
intertask communications. In general, the Executive monitors, 
controls, and services system-level activity. It provides a 


relatively machine-independent environment in which to develop 
and run uSer applications. 


The Executive resides in low memory. On systems supporting the 
memory management option, the Executive is permanently mapped by 
the KERNEL mode mapping registers ranging from KERNEL virtual 
address 0 up to KERNEL virtual address 120000(8). The 
Executive's permanently mapped address space contains the 
Executive code, the 1/0 device data base, and the system pool. 


pool 


Pool (also known as the dynamic storage region, or DSR) is a 
contiguous area in memory, allocated by the Executive and used as 
a work space for storing system data structures such as system 
lists and control blocks. Pool is included at the top of the 
Executive's permanently mapped address space in memory. The size 
of pool must be sufficient to handle all of the dynamic storage 
requests of the system. By default, SYSGEN extends the mapped 
system Executive to its maximum size to create the largest 
possible pool space. 


FCS (File Control Services) 


FCS is a set of routines that can be used in tasks to read and 
write files. FCS provides a set of macros to simplify the user 
interface to the system I/O structures. The FCS routines’ serve 
as an intermediary between tasks and an ACP or a device driver. 


Task input to FCS is in the form of data structures and calls’ to 
the FCS subroutines. The output from FCS is QIO directives for 
an ACP or device driver to process. FCS provides a convenient 
and device-independent interface for a task instead of the task 
issuing QIOs directly. 
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ACP (Ancillary Control Processor) 


An Ancillary Control Processor (ACP) is a privileged program 
interfacing between a device driver and the Executive or a user 
program. An ACP acts as part of the I/0 processing for a 
particular device or group of devices and is commonly requested 
to process an I/O request that must be translated to one or more 
simpler I/0 requests that a device driver can process. The main 
difference between an ACP and a device driver is that an ACP 
services a class of devices (such as disks), whereas a driver 
services a specific device type (such as RLO2s). An ACP becomes 
associated with a device through either a MOUNT command or by 
some other special, privileged interface associated with the ACP. 


Files-1l ACP 


Files-1l ACP is a special ACP supplied with RSX-11M that, like 
other ACPs, becomes associated with a device or devices by the 
MOUNT command. Once associated with the device, it intercepts 
certain I/0 requests issued by programs as determined necessary 
by the I/O system in the Executive. In particular, the Files-1l 
ACP handles requests to create files, to extend files, to delete 
unneeded files, and to access files. Files-11 ACP is responsible 
for the maintenance of the volume structure of a Files-11 disk, 
which includes the directory structure, storage allocation and 
deallocation, and file security. 


driver 


A driver is a set of routines called by the Executive in response 
to I/O requests from user programs. One of those routines is the 
interrupt service routine, whose specific function is to service 
device interrupts. (See the definition of a vector.) The driver 
translates I/O requests into instructions directed to a_ specific 
device type. A driver is actually an extension of the Executive. 
It provides the software interface between a user and the device 
itself. 


Each type of peripheral device has its own driver. Because 
driver code may take substantial space in memory, you have the 
option in SYSGEN to make specific drivers memory-resident or 
loadable. Refer to the RSX-11M Guide to Writing an I/O Driver 


CSR (Control and Status Register) 


Every peripheral device has a unique address on the communication 
bus (UNIBUS or Q-BUS). When addressing a device, you are 
actually addressing a set of registers that communicate with the 


device. One of the registers is called the Control and Status 
Register (CSR). 


interrupt 


An interrupt is the mechanism whereby the various external 
hardware subsystems communicate a need for software servicing. 


vector 


Every device corresponds, through the system hardware, to a 
unique two-word location in the low end of memory called a 
vector. (The memory locations from 0 through 776 are the vector 
areas.) Each vector stores the PSW (Processor Status Word) and PC 
(program counter) of the interrupt service routine for a specific 
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device. When a device interrupts the CPU, the CPU saves’ the 
current PSW and PC on a stack and loads the PSW and PC from the 
device's vector. The address in the new PC points to the 
interrupt service routine. 


Not all vectors are assigned to peripheral devices. Some are 
reserved for software interrupts. For example, execution of the 
TRAP instruction causes an interrupt where a new PSW and PC are 
loaded from the vector reserved for use only by the TRAP 
instruction. . 


In addition, there are what is known as "floating vectors." 
Floating vectors are those addresses from location 300 through 
location 776. The assignment of devices to those vectors is left 
to the discretion of the system manager and the Field Service 
representative. Generally, floating vectors are used for 
assigning multiple devices of a given type that require more than 
one controller. 


hardware bootstrap 


A hardware bootstrap is a process whereby a user initiates a 
software (RSX-11M) system startup by using the console switches 
and/or the console terminal to instruct the bootstrap ROM to load 
the hardware bootblock record from an input device into memory. 
The bootblock record contains the code to load the system image 
into memory. 


software bootstrap 


A software bootstrap is a process whereby a privileged user 
initiates a new software system startup from an already running 
system. Software bootstrapping requires the use of the MCR BOOT 
command. (See the RSX-11M/M-PLUS MCR Operations Manual, 
particularly the SAVE and BOOT commands, for details on software 
bootstrapping.) Any valid RSX-11M system image can be software 
bootstrapped. 


mapped system 


PDP-11l processors supporting memory management hardware are known 
as mapped systems. That is, the memory management hardware 
converts virtual addresses to physical addresses in memory. In 
addition, the memory management hardware makes it possible to 
access and address more memory by mapping 16-bit addresses to 
virtual 16-bit, 18-bit, or 22-bit locations. For contrast, see 
the definition of an unmapped system. | 


unmapped system 


An unmapped system is a system on which a virtual address 
corresponds exactly to a physical address. For example, the 
virtual address 125003 corresponds to the physical location 
125003 in memory. Unmapped systems support up to 30K words of 
memory, with 2K words left over to map the I/O page--the extent 
of 16-bit addressing. 


baseline system 


The baseline system is the stand-alone RSX-11M system included as 
part of the distribution kit. It contains only those software 
components necessary for you to generate an RSX-11M system. You 
bootstrap the baseline system from the distribution kit into the 
memory of your host computer. The baseline system then dedicates 
the host computer's resources to the system generation process. 
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target system 


host 


The term target system refers to the operating system produced by 
the system generation procedure as well as the hardware 
configuration on which it is intended to run. System generation 
may take place on the target system computer or on a different 
computer (see "host system"). In either case, RSX-11M system 
generation must be done uSing a PDP-11 processor. 


system 


The host system is that system on which you perform an RSX-11M 
system generation. It may be the same hardware on which you 
intend to run your new target system or it may be a _ separate 
configuration that is more convenient for system generation. 


on-line system 


An on-line system iS an operating environment that _ shares 
resources with other processing or development work in progress. 
In the context of SYSGEN, generating RSX-11M on line means’ that 
you are using host system software other than the baseline system 
provided on the distribution kit. 


stand-alone system 


A stand-alone system is an operating environment that is 
dedicated to a single activity. In the context of SYSGEN, 
generating RSX-11M stand-alone means that you are using the 
baseline system provided on the distribution kit. That is, you 
bootstrap the baseline system from the distribution kit into your 
host computer's memory, thereby dedicating the host computer to 
your use alone while you perform the system generation. 


unsaved system 


The term unsaved system refers to the state of the system image 
after VMR has executed SYSVMR.CMD and before the system has been 
saved. (Refer to the SAVE command in the RSX-11M/M-PLUS MCR 
Operations Manual.) The unsaved system should be bootstrapped 
only on the target system for which it was configured during the 
system generation process. 
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PREPARING FOR SYSTEM GENERATION 


This chapter tells you how to prepare for the system generation 
procedure. It begins with a description of the various RSX-11M 
distribution kits and then it lists step-by-step instructions for 
copying the distribution kits. Next, the chapter briefly discusses 
the host environments you can use to generate your RSX-11M Version 4.2 
operating system. Finally, the chapter concludes with a description 
of the procedures for updating your system. 


2.1 WHAT IS A DISTRIBUTION KIT? 


RSX-11M distribution kits are the magnetic tape or disk media 
containing the source, object, task, and command files needed to 
generate your RSX-11M_ system. There are four general types of 
distribution kits: 


e Magnetic tape kits (800 or 1600 bpi) 
e TK50 magnetic tape cartridge kits 

e RKO6 and RKO7 disk kits 

@e RLO1l and RLO2 disk kits 


The RKO6/RKO7 and RLO1/RLO2 distribution kits are distributed on 
either magnetic tape or disk media. All other disk kits are 
distributed on magnetic tape only. 


Table 2-1 lists an inventory of RSX-11M distribution kits. Each 
distribution kit contains either magnetic tapes or disks, depending on 
the type of kit ordered. The table shows the number of magnetic tape 
or disk volumes that each kit consists of. 


Check the contents of your distribution kit against the information in 
Table 2-1 to ensure that you have a complete kit. 


Each distribution kit contains an RSX-11M operating system known as 
the baseline system. The baseline system contains just enough 
features to allow you to perform a system generation. There is a 
mapped baseline system (located on the tape or disk labeled RSXM38) on 
each kit in directory [1,54]. 


Regardless of whether your distribution kit is on magnetic tape or 
disk, you can use only disk media to perform an RSX-11M system 
generation. 
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Table 2-1 
Inventory of the RSX-11M Distribution Kits 


Kit Type Number Number. of Tape Tape 
of Disks Tapest Length Density 
(ft) ( bpi) 


Magnetic Tape - 1 2400 1600 
2 2400 800 

TK50 - 1 - 6667 

RLO1 Disk 7 ae - 

RLO2 Disk 5 - - 

RKO6 Disk 2 - = 

RKO7 Disk i - - 


CL A A A NT nese SES 


1. Each tape distribution kit includes an additional tape that 
contains a stand-alone BRU system. 


Each volume in your distribution kit bears a physical label that 
identifies the following: 


e The specific software version number (such as RSX-11M 
Version 4.2) 


e The type of distribution kit (such as RL1 or RL2) 


NOTE 


Because of character string limitations on the 
physical tape label, the type of distribution kit 
specified on the label omits zeros. For example, the 
RLO1 and RLO2 kits are labeled RL1L and RL2, 
respectively. 


e The volume ID (such as RSXM38) 


e The number in the sequence (such as 1/2--the first disk in a 
set of two) 


e Additional information for tape that specifies the file format 
(such as BRU) and the tape density (such as MT:1600) 


Figure 2-1 shows an example of an external, physical magnetic tape 
label and an external, physical disk label for the RSX-11M Version 4.2 
distribution kits. 
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BB-L952B-BC 
RSX11M V4.2 BRU MT:1600 1/1 
RL1/2 ID:RSXM38 


Digital Equip 
Men} 
Co, 


4928 


AM-D519D-BC 
RSX11M V4.2 ID:RSXM38 RK6 1/2 


© 1985 Digital Equipment Corporation 


ZK-1110-82 


Figure 2-1 Examples of External Labels 
for RSX-11M Magnetic Tapes and Disks 


2.2 OPERATING ENVIRONMENTS FOR GENERATING RSX-11M 


To perform an RSX-11M system generation, you must have an _ operating 
system to control the host computer's resources, (The host computer 
is the computer on which you are generating your new RSX-11M_ system.) 
You can generate your system on a stand-alone host computer, or on an 
on-line host computer. If you use an on-line host computer, it can be 
running under the control of an RSX-11M or RSX-11M-PLUS operating 
system, or it can be a VAX computer running in VAX-11 RSX 
compatibility mode. 


2.2.1 Stand-Alone System Generation 


You can generate your system by using an RSX-11M Version 4.2 baseline 
system. Generating an RSX-11M system from the baseline system is 
called stand-alone system generation, because the baseline system 
dedicates the host computer's resources to the system generation 
procedure alone. The baseline system consists of the software 
components necessary for system generation. Stand-alone system 
generation requires that you hardware bootstrap the baseline disk 
(RSXM38) to load the baseline system into memory. Further information 
on stand-alone system generation appears in Chapter 4. 


2.2.2 On-Line System Generation on an RSX-11M Host 


You can generate your system by using a host computer that is 
currently running an RSX-11M Version 4.1 system, or a Version 4.2 
system other than the baseline system. This is known as an _ on-line 
system generation. This procedure requires specific logical device 
assignments before you begin the system generation. Further 
information on on-line system generation appears in Chapter 4. 
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2.2.3 On-Line System Generation on an RSX-11M-PLUS Host 


You can generate your system by using a host computer that is 
currently running an RSX-11M~PLUS Version 2.1 system, or a Version 3.0 
system other than the baseline system. This procedure requires 
certain privileges and conditions before you begin the system 
generation. Refer to Section 2.5.1 for instructions on performing a 
system generation on an RSX-11M-PLUS host. 


2.2.4 On-Line System Generation on a VAX-1l RSX Host 


You can generate your system by using a VAX/VMS host computer that is 
currently running in VAX-11 RSX compatibility mode (VAX-11 RSX Version 
1.0, or Version 2.0). This procedure requires certain privileges and 
conditions before you begin the system generation. Refer to Section 
2.5.2 for instructions on performing a system generation on a VAX-11 
RSX host. 


2.3 COPYING THE DISTRIBUTION KIT 


Before you use your distribution kit to generate an RSX-11M_ system, 
make a copy of the kit. In this way, the original distribution kit 
serves as a backup in case the copy is corrupted during the system 
generation process. Also, the distribution kit serves as_ base 
software against which you can apply subsequent Updates. (If you need 
to apply an Update to your system, you should do it before invoking 
SYSGEN Phase I.) 


If you have a magnetic tape distribution kit, you must copy the 
contents of the kit to a blank disk. After you have copied the kit to 
the disk, the disk becomes your target system disk. 


Since you must copy a magnetic tape distribution kit to a disk before 
you invoke SYSGEN, the distribution tape can then serve as your 
permanent backup copy. 


If you have a disk distribution kit, you must make a copy of the 
distribution kit that you can use as the target system disk. 


Details for copying each particular distribution kit appear in each of 
the following sections. Section 2.3.1 tells you how to copy any of 
the distribution kits stand-alone using the BRU64K, BRUSYS (for the 
TK50 cartridge tape), and baseline stand-alone systems. Section 2.3.2 
tells you how to copy any of the distribution kits using a host 
computer already running RSX-11M. Go to the section that applies to 
your distribution kit and follow the instructions for copying the kit. 


2.3.1 Copying Kits Stand-Alone 


The following sections describe the procedures used to copy each type 
of distribution kit using the BRU64K, BRUSYS, and baseline stand-alone 
systems. 
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2.3.1.1 The BRU64K and BRUSYS Systems - Each distribution kit 
contains a BRU system. Each tape distribution kit, except for the 
TK50, includes a 600-foot tape that is labeled BRU64K. The TK50 tape 
kit includes a second TK50 cartridge that is labeled BRUSYS. Each 
disk distribution kit contains the files BRU64K.SYS and BRUSYS.SYS in 
directory [1,5l]. This directory is located on the RSXM38 volume of 
the RKO6/RKO7 kit, the RLUTIL volume of the RLO1 kit, and the PRVBLD 
volume of the RLO2 kit. 


The BRU64K and BRUSYS systems are limited-feature, memory-resident 
RSX-11S systems. You use them to prepare the target system disk and 
then to copy the baseline system from the magnetic tape distribution 
kit to the disk. After you copy the tape to the disk, you use the 
baseline system on the disk as the operating environment for a 
stand-alone system generation. 


Included with the BRU64K and BRUSYS systems are copies of the 
following utilities: 


@ Backup and Restore Utility (BRU) 


e Bad Block Locator Utility (BAD) 


NOTE 


Since BRU and BAD share the same buffer space, the two 
utilities cannot be run simultaneously. 


Also included is a special-purpose configuration program called the 
RSX-11M/M-PLUS Stand-Alone Configuration and Disk Sizing Program 
(CNF). CNF lets you change the default values for the device control 
and status register (CSR) address (/CSR=nnnnnn), and for the device 
vector (/VEC=nnn). For MM:-type devices, you can also change the 
default formatter number (which is 0), by using the /FOR=n switch. 
Unless you specify other values, the BRU systems assume the default 
CSR and vector address values for your devices. The following list 
shows the default addresses for device types: 


Device CSR Vector CSR Status 
DB 176700 254 Present 

DK 177404 220 Present 

DL 177440 160 Not Present 
DM 177440 210 Present 

DP 176714 300 Present 

DR 176300 150 Present 

DU 172150 154 Not Present 
MM FOR=0 172440 330 Present 

MS 172522 224 Not Present 
MT 160000 320 Not Present 


Additionally, BRUSYS expects the following addresses for MU:-type 
devices: 


Device CSR Vector CSR Status 


MU 174500 260 ‘Present 


PREPARING FOR SYSTEM GENERATION 


If your devices are at different CSR and vector addresses or if your 
MM:-type magnetic tape drive device is on a different formatter 
number, you must change the values in BRU64K or BRUSYS. You can do 
this by using the following CNF switches when you enter the device 
name: 


/CSR=csr address 
/VEC=vector address 
/EOR=formatter number 


The vector addresses that BRU64K and BRUSYS expect for DR:-, MS:-, and 
MT:-type devices are nonstandard. The CSR address that the BRU 
systems expect for DR:-type devices is also nonstandard. If you are 
using one of these devices as an input or output device, you will 
always have to change the values in BRU64K or BRUSYS to match the CSR 
and vector addresses of your hardware. You can enter the standard 
values for these devices by using the following responses to the CNF 
prompt: 


DR: /CSR=176700/VEC=254 
MS: /VEC=224 
MT: /VEC=224 @e? 


To begin copying your distribution kit, you must hardware bootstrap 
the BRU64K or BRUSYS stand-alone system on your host computer. The 
procedure for hardware bootstrapping the BRU systems depends on the 
bootstrap hardware present on the host computer. (Appendix B 
describes hardware bootstrap procedures.) 


Following are the procedures for copying distribution kits on a 
stand-alone host system. 


If you have a magnetic tape distribution kit, read Section 2.3.1.2 
next. 


If you have an RKO6 or RKO7 disk distribution kit, read Section 
2e3ele3 NEXts 


If you have an RLOl or RLO2 disk distribution kit, read Section 
2.3.1.4 next. 


2.3.1.2 Copying a Magnetic Tape Kit Stand-Alone - Use the following 
procedure to copy the 800 bpi or 1600 bpi magnetic tape kits or the 
6667 bpi TK50 cartridge tape kit using a host computer stand-alone. 
The "output disk" referred to in this section is the blank disk you 
intend to use as the target system disk. All commands shown in this 
section are issued to the RSX-11S Basic MCR command line interpreter. 


You will need one to seven blank disks to copy the distribution kit, 
depending on the type of distribution kit that you have. The first 
disk will be your system disk after your system generation is 
complete. Place a physical label on the disk so that the blank disk 
represents the backup set name in the distribution kit (RSXM38). 


To copy your distribution tape(s) to disk using a stand-alone host 
system, perform the following steps: 


1. Load the BRU64K tape on the appropriate tape drive. (If you 
have the TK50 tape kit, you will be using BRUSYS instead of 
BRU64K, so mount the tape labeled BRUSYS.) Next, load the 
blank disk, which you have previously labeled RSXM38, in the 


PREPARING FOR SYSTEM GENERATION 


appropriate disk drive and spin up the disk. If your medium 
is an RA80/RA81, RC25, RD52/RD53 or RM80 disk (all 
fixed-media disks), the fixed-media disk serves as the blank 
disk. 


Hardware bootstrap the BRU64K or BRUSYS' tape. (Refer to 
Appendix B for the hardware bootstrap procedures.) The 
RSX-11S stand-alone system prints an identification line on 
your terminal, then begins to run the Stand-Alone 
Configuration and Disk Sizing Program (CNF). 


Enter the device specifications in response to the prompts 
from CNF. The "first device" is the tape drive that will 
contain the RSX-11M Version 4.2 distribution kit tape. The 
“second device" is the drive containing the output disk. 


If the magnetic tape controller or the disk controller, or 
both, are not connected to the default CSR or vector 
addresses that BRU64K or BRUSYS expects, you must modify the 
software to incorporate the correct addresses before you can 
complete this step. If you want to check your CSRs_ and 
vectors against the list of default CSR and vector addresses, 
enter the /DEV switch in response to the first CNF prompt. 
For example: 


Enter first device: /DEV 


Device CSR Vector CSR Status 
DB 176700 254 Present 
DK 177404 220 Not Present 


If your devices are at CSR and vector addresses other than 
those that BRU64K or BRUSYS expects, or if your MM:-type 
Magnetic tape drive is on a formatter number other than zero, 
you must change the values in BRU. Do this by using the 
following CNF switches when you enter the device name: 


/CSR=csr address 
/VEC=vector address 
/FOR=formatter number 


The vector addresses that BRU64K and BRUSYS expect for DR:-, 
MS:-, and MT:-type devices are nonstandard. The CSR address 
that BRU expects for DR:-type devices is also nonstandard. 
If you are using one of these devices as an input or output 
device, change the values in BRU to match the CSR and vector 
addresses of your hardware. 


For example, assume you have a TU16 magnetic tape with the 
default addresses, and an RMO2 disk at standard CSR and 
vector addresses of 176700 (octal) and 254 (octal), 
respectively. Assuming that the unit number for both units 
is zero, the following is the sequence of commands to CNF: 


Enter first device:MMO: 


Enter second device: DRO: /CSR=176700/VEC=254 
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Press RETURN, then enter the date and time using the 
command. Use the TIME command again to verify th 
entered the correct date and time. For example: 


TIME 
at you 


Hit RETURN and enter date and time as 'TIM HH:MM MM/DD/yyY' 


>TIM 14:32 05/25/85 
>TIM GED 

14:32:01 25-MAY-85 

> 


Run the Bad Block Locator Utility (BAD) on your output 
For example, if your output device is DRO:, use the fol 
command sequence: 


>RUN BAD 

> 

BAD> DRO:/LIST 

BAD -- DRO: Total bad blocks= 0. 
BAD > CTRLz) 

> 


disk. 
lowing 


The BAD /LIST switch lists any bad blocks as they are 


located. 


Repeat this step for each of the blank disks that you are 


copying the distribution kit to. 


Remove the BRU64K tape or the BRUSYS cartridge from the 
and mount the distribution kit tape labeled RSXM38 
tape drive previously entered to CNF. 


drive 
on the 


You are now ready to copy the files from the distribution 
tape to the disk. To do so, run the Backup and Restore 


Utility (BRU), using the following command line: 


>RUN BRU 
BRU>/REW/INI/DEN:density/BAC:name mmn: ddn: @éD 


The switches and parameters in the BRU command line hav 
following functions: 


e the 


ae The /REW (rewind) switch ensures that the tape is 


completely rewound before BRU begins to copy. 


b. The /INI (initialize) switch initializes the disk 
to which BRU is copying. (Be aware that if there a 
files on the disk, they will be deleted.) 


c. The /DEN (density) switch specifies the density at 
the tape was written. 


volume 
re any 


which 


d. The /BAC (backup_set) switch identifies the BRU backup 


set that you want to copy. A backup set is the u 
data that is directed to or from a volume with a 
BRU command line (during a single backup or r 
operation). The distribution tape consists of a 


nit of 
Single 
estore 
series 


of BRU backup sets, all or some of which are copied to 
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the target system disk, depending on which type of disk 
you are copying to. Each type of disk has a name that 
you use with the /BAC switch to identify it. The 
following list shows the name for each type of disk: 


Disk Type Name 
RP04/RP05/RP06 DBSYS 
RLO1/RLO2 DLSYS 
RKO6/RKO7 DMSYS 
RMO02/RM03/RM05/RM80 DRSYS 
RA60/RA80/RA81/RC25/RD52/RD53 DUSYS 


e. The mmn: specification identifies the tape device and 
unit that you are copying from. 


f. The ddn: specification identifies the disk device and 
unit that you are copying to. 


For example, to begin copying the tape labeled RSXM38 
(mounted on device MMO0:) to an RKO6 disk, issue the following 
command : 

BRU>/REW/INI/DENS: 800/BAC:DMSYS MM: DM1: @eé 

BRU - Starting Tape 1 on MMO: 

BRU - End of Tape 1 on MMO: | 


BRU - Completed 


In response to your command, BRU copies the backup set named 
DMSYS from the tape and displays a message when the copy 
operation is complete. You have now copied the backup’ set 
for the type of disk you are copying to. This backup set 


includes indirect command files named STARTUP.CMD and 
TAPEKIT.CMD that will copy the remainder of the distribution 
kit to the disk for you. The remaining steps in this 


procedure show you how to invoke the command files. 


Hardware bootstrap the disk (labeled RSXM38) that you have 
copied from the distribution tape. (Refer to Appendix B for 
instructions on bootstrapping.) When you bootstrap the disk, 
the system will display a series of messages and will prompt 
you for input. The following example illustrates this 
process, using an RK06 disk: 


>RED DM1: SY: (ED 

>RED DM1l: LB: (ED 

>MOU DM1:RSXM38 
>@DM1: [1,2] STARTUP ¢€7) 


PLEASE ENTER TIME AND DATE (HR:MN DD-MMM-YY) [S]: 18:50 26-MAY-85 


>TIM 18:50 26-MAY-85 QED 
ENTER LINE WIDTH OF THIS TERMINAL [D:132]: 


>SET BUF=TI:132 
>ACS SY:/BLKS=1024 
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9. Invoke the TAPEKIT command procedure (by issuing the command 
@TAPEKIT), and answer the questions that TAPEKIT displays. 
The example that follows the note below shows the process 
that TAPEKIT conducts in order to copy the remaining backup 
sets from the distribution kit to the disk. 


' NOTE 


If the recording density of the tapes in your 
kit is 800 bpi, TAPEKIT will display a 
message to notify you when it is time _ to 
mount the second tape. TAPEKIT then copies 
the contents of the second tape to your 
disks. If the data copying operation fails, 
TAPEKIT displays a message to notify you of 
the failure. In such a case, retry the copy 
operation. If the copying fails again, retry 
the copy procedure using a different output 
disk. If the copy operation still fails, it 
is likely that either your distribution kit 
is defective and should be replaced, or your 
hardware needs to be checked. 


The following is an example of the TAPEKIT procedure: 


>@TAPEKIT 


; RSX-11M V4.2 BL38 tape distribution kit extraction procedure 
; Started on 26-MAY-85 at 18:51:05 


>INS LB: $BRU 


a 
>* Enter disk type, RKO6 or RKO7 [D:RKO7] [S]:RK06 (ED 
>* Enter second drive and unit [ddn:] [S]:DMO: 


>* Enter drive and unit with tape distribution kit [ddn:] [S]:MM: Qe? 
>* Density [D:1600] [S]:800 @eD 


>; 

>LOA MM: /PAR=GEN 

>; 

Copying rest of RSXM38 ... 
>; 


>BRU/DENS: 800/NOINI/UFD/BAC:RSXBAS MM: DML: 
BRU - Starting Tape l 


BRU - End of Tape l 
BRU - Completed 


>BRU/DENS: 800/NOINI/SUP/UFD/BAC:EXCPRV MM: DM1: 
BRU - Starting Tape 1l 


BRU - End of Tape l 
BRU ~ Completed 


>BRU/DENS : 800/NOINI/SUP/UFD/BAC: PRVBLD MM: DM1: 
BRU - Starting Tape l 


BRU - End of Tape 1l 


BRU - Completed 
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>BRU/DENS: 800/NOINI/SUP/UFD/BAC:RLUTIL MM: DML: 
BRU - Starting Tape 1 


BRU - End of Tape l 
BRU - Completed 


>} 

>* Unload tape labeled RSXM38 1/2 from MMO: 
>}; 

>; Load tape labeled RSXM38 2/2 on MMO: 

>* Is MMO: ready? [Y/N] :¥ @ED 

>; 

>; Load disk labeled CLISRC in DMO: 

>* Is DMO: ready? [Y/N] :Y Qe) 


>MOU DMO:/FOR 

>BRU/DENS : 800/INI/BAC:MCRSRC/OUT:CLISRC MM: DMO: 

BRU - Starting Tape 1 

BRU - This disk will not contain a hardware bootable system 


BRU - End of Tape 1 on MMO: 


BRU - Completed 


>DMO DMO: 
DMO -- TTO: dismounted from DMO: *** Final dismount initiated *** 
19:02:31 *** DMO: -- Dismount completely 


>MOU DMO:CLISRC 

>BRU/DENS: 800/NOINI/SUP/UFD/BAC:HLPDCL MM: DMO: 
BRU - Starting Tape l 

BRU - End of Tape 1l 

BRU - Completed 


>BRU/DENS: 800/NOINI/SUP/UFD/BAC:RMSV20 MM: DMO: 
BRU - Starting Tape 1 


BRU - End of Tape 1 


BRU - Completed 


>DMO DMO: 
DMO -- TTO: dismounted from DMO: *** Final dismount initiated *** 
19:07:07 *** DMO: -- Dismount complete 


>; Unload disk labeled CLISRC from DMO: 
’ 
>; Completed on 26-MAY-85 at 19:07:09 
>@ <EOF> 
When the TAPEKIT procedure is completed, you are ready to begin 
generating your RSX-11M system. Refer to Chapter 3 for details on the 


structure of SYSGEN. It is important that you read Chapter 3 before 
you begin generating your system. 
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2.3.1.3 Copying the RKO6 or RKO7 Disk Kit Stand-Alone - Use’ the 
following procedures to copy the RKO6 or RKO7 disk kit on a 
stand-alone host computer. The term “output disk" or "blank disk" in 
this section refers to the disk or disks that you are using as the 
target system disk. All commands shown in this section are issued _ to 
the RSX-11S Basic MCR command line interpreter. 


NOTE 


Whereas the RK06 distribution kit consists of two 
disks, the RKO7 kit contains the entire distribution 
kit on a single disk. Therefore, if you have an RKO7 
kit, when you perform the following procedure, follow 
the first eight steps only. 


You will need two blank disks to copy the RKO6 distribution disks, and 
one blank disk to copy the RKO7 disk. (Place a physical label on each 
disk so that the blank disks represent the labels on the respective 
disks in the distribution kit.) 


To copy the disk distribution kit using a stand-alone system, perform 
the following steps: 


1. Load the distribution disk labeled RSXM38 and the blank disk 
in the appropriate drives and spin them up. 


2. Determine the correct hardware bootstrap procedure for the 
disk drive on which RSXM38 is mounted. (See Appendix B for 
information regarding the hardware bootstrap routines.) 


3. Bootstrap the baseline system on the RSXM38 disk by using the 
appropriate bootstrap routine for your processor and disk 
drive. When the baseline system comes up, it prints. the 
following identification line on your terminal: 


RSX-11M V4.2 BL38 124.K MAPPED (BASELINE) 


>@ <EOF> 
> 


At this point, system initialization is complete and you may 
proceed to step 4. 


4. RSXM38 contains the BRU64K system that you need to copy the 
distribution kit. Therefore, software bootstrap the BRU64K 
system, which runs the RSX-11S stand-alone system. For 
example, if RSXM38 is in DMO0O:, enter the following commands: 


>INS SBOO@ED 
>BOO DMO: [1,51]BRU64K 


Notice that you must first install the BOO (boot) task before 
you can software bootstrap BRU64K. 
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NOTE 


When copying the distribution disks, you 
should write-protect the disk from which you 


are copying data. To do this, press’ the 
write protect button on the front of the disk 
drive. 


The RSX-11S stand-alone system prints an identification line 
on your terminal, then begins to run the Stand-Alone 
Configuration and Disk Sizing Program (CNF). 


Enter the device specifications in response to the prompts 
from CNF. The "first device" is the drive containing the 
RSXM38 distribution kit disk. The "second device" is the 
drive containing the output disk. 


If one or both of the disk controllers are not connected to 
CSR and vector addresses that BRU64K expects, you must modify 
the software to incorporate the correct addresses before you 
can complete this step. If you wish to check your CSRs and 
vectors against the list of default CSR and vector addresses, 


enter the /DEV switch in response to the first CNF prompt. 
For example: 


Enter first device:/DEV 


Device CSR Vector CSR Status 
DB 176700 254 Present 
DK 177404 220 Not Present 


If your devices are at CSR and vector addresses other than 
those that BRU64K expects, you must change the values in 
BRU64K. Do this by using the following CNF switches when you 
enter the device name: 


/CSR=csr address 
/VEC=vector address 
/FOR=formatter number 


For example, assume your first RK0O6 disk device (the one 
containing RSXM38) is at nonstandard CSR and vector addresses 
of 176714(octal) and 300(octal), respectively, and your 
output RKO6 disk device has the default addresses. Assuming 
that the unit numbers for both units are zero and one, 
respectively, the following is the sequence of commands to 


CNE: 

Enter first device:DM0: /CSR=176714/VEC=300 @éD 

Enter second device:DM1l: 
Press RETURN, then enter the date and time using the TIME 
command. Use the TIME command again to verify that you 
entered the correct date and time. For example: 


Hit RETURN and enter date and time as 'TIM HH:MM MM/DD/YY' 


>TIM 14:32 05/25/85 


>TIM 
14:32:01 25-MAY-85 
> 
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Run the Bad Block Locator Utility (BAD) first on the blank 
disk labeled RSXM38. For example, if your output device is 
DM1:, use the following command sequence: 


>RUN BAD 
BAD> DM1:/LIST 


BAD -- DMI: Total bad blocks= 0. 
BAD> CiRLZ) 
> 


The BAD /LIST switch lists any bad blocks as they are 
located. 


Run the Backup and Restore Utility (BRU) to copy the RSXM38 
distribution kit disk to the output disk. For example, if 
your output disk is DMl:, use the following command sequence: 


>RUN BRU 


BRU> /INI/VER (@ED 
From: DMO: RED 
To: DM1: (RED) 


The BRU /INI (initialize) switch initializes the disk volume 
to which BRU is copying. (Be aware that if there are any 
files on the disk, they will be deleted.) 


The BRU /VER (verify) switch causes BRU to verify the data 
after it is copied. BRU issues the following message to the 
terminal indicating that it has begun to verify the data 
copied: 


BRU - Starting verify pass 


NOTE 


If the verify fails, do not attempt the 
system generation without first retrying the 
backup operation. If the verify fails again, 
retry the backup operation using a new output 
disk. If the verify fails once again, it is 
likely that either your distribution kit is 
defective and should be replaced or your 
hardware needs to be checked. 


When RSXM38 is successfully copied, BRU issues the following 
message at your terminal to indicate that it has finished: 


BRU - Completed 
BRU> Cializ) 
> 


If you have an RKO7 distribution disk, the copying process is 
now completed. If you have an RKO6 distribution kit, spin 
down both disks and remove’ them. Replace the first 
distribution disk with the second one, labeled CLISRC. 
Replace the new copy of RSXM38 with the second blank disk, 
and spin up both disks. Again, write-protect the disk from 
which you are copying data. 
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10. Repeat Steps 7 and 8 in this procedure with the CLISRC disk. 
NOTE | 


The following warning message from BRU 
reminds you that the second disk being copied 
cannot be hardware bootstrapped: 


BRU - This disk will not contain a hardware bootable system 


You can hardware bootstrap the baseline disk 
only (the disk labeled RSXM38). 


At this point, you have completed the disk-to-disk copy of the 
distribution kit and are ready to bootstrap the baseline system on the 
RSXM38 disk and generate your RSX-11M system. Refer to Appendix B for 
information on bootstrapping your baseline system. Then turn to 
Chapter 3 for details on the structure of SYSGEN. It is important 
that you read Chapter 3 before you begin generating your system. 


2.3.1.4 Copying the RLO1/RLO2 Disk Kit Stand-Alone - Use the 
following procedures to copy the RLOl or RLO2 disk kit using a 
stand-alone host computer. The term "output disk" or "blank disk" in 
this section refers to the blank disks that you are using as the 
target system disks. All commands shown in this section are issued to 
the RSX-11S Basic MCR command line interpreter. 


The RLO1 kit consists of seven disks. The RLO2 kit consists of only 


five disks because two RLO02 disks contain the contents of two RLO1] 
disks. The disk labels and contents are: 


RLO1 RLO2 
Disk Label Disk Label RLO1 Volume (s) 
RSXM38 RSXM38 RSXM38 
EXCPRV EXCPRV EXCPRV 
PRVBLD PRVBLD PRVBLD, RLUTIL 
RLUTIL MCRSRC MCRSRC, HLPDCL 
MCRSRC RMSV20 RMSV20 
HLPDCL 
RMSV20 


The baseline disk (RSXM38) does not include the stand-alone BRU64K 
utility. Therefore, to create a backup copy of your distribution kit 
on a stand-alone system, you must first bootstrap the baseline system, 
then software bootstrap BRU64K (described in Step 5) from the 
distribution disk labeled RLUTIL (PRVBLD in the RLO2 kit). 


You will need seven blank RLO1, or five blank RLO2, disks to copy the 
entire distribution kit. (Place a physical label on each disk so that 
the blank disks represent the volume names in the distribution kit.) 
However, only the first four volumes (RSXM38, EXCPRV, PRVBLD, and 
RLUTIL) are used during a system generation. See 
post-system-generation guidelines in Chapter 6 to determine whether or 
not you need to copy the remaining backup sets. 


To copy the disk distribution kit using a stand-alone system, perform 


the following steps (if you have an RLO2 distribution kit, substitute 
the disk labeled PRVBLD for the disk labeled RLUTIL throughout’ the 
following procedure): 
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Place the baseline disk (RSXM38) and the distribution disk 
labeled RLUTIL in the appropriate drives and spin them up. 


Determine the correct hardware procedure for the disk drive 
on which the baseline disk is mounted. (See Appendix B for 
information regarding the hardware bootstrap routines.) 


Bootstrap the baseline system on the RSXM38 disk by using the 
appropriate bootstrap routine for your processor and disk 
drive (see Appendix B). When the baseline system comes up, 
it prints the following identification line on your terminal: 


RSX-11M V4.2 BL38 124.K MAPPED (BASELINE) 


>@ <EOF> 
> 


At this point, system initialization is complete and you may 
proceed to step 4. 


The RLUTIL disk contains the BRU64K system that you need to 
copy the distribution kit. Therefore, when the baseline 
system comes up, software mount RLUTIL. For example, if your 
baseline disk is on DLO: and HLPDCL is on DL1:, enter the 
following command to mount RLUTIL: 


>MOU DL1:RLUTIL RED 


Software bootstrap the BRU64K system, which runs the RSX-11S 
stand-alone system. For example, if RLUTIL is in DL1:, enter 
the following commands: 


>INS $BOO 
>BOO DLI1: [1,51]BRU64K GED 


Notice that you must first install the BOO (boot) task before 
you can software bootstrap BRUO64K. 


The RSX-11S stand-alone system prints an identification line 
on your terminal, then begins to run the Stand-Alone 
Configuration and Disk Sizing Program (CNF). 


Remove the RLUTIL distribution disk from DLl:, physically 
mount the blank disk labeled RSXM38 in the drive, and spin up 
the disk. Also, write-protect the RSXM38 distribution disk 
by pressing the write-protect button on the face of the disk 
drive. 


Enter the device specifications in response to the prompts 
from CNF. The "first device" is the drive containing the 
RSXM38 distribution kit disk. The "second device" is the 
drive containing the output disk labeled RSXM38. 


If one or both of the disk controllers are not connected to 
CSR and vector addresses that BRU64K expects, you must modify 
the software to incorporate the correct addresses before you 
can complete this step. If you wish to check your CSRs and 
vectors against the list of default CSR and vector addresses, 
enter the /DEV switch in response to the first CNF prompt. 
For example: 


Enter first device:/DEV 


2-16 
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Device CSR Vector CSR Status 
DB 176700 254 Present 
DK 177404 220 Not Present 


If your devices are at CSR and vector addresses other’ than 
those that BRU64K expects, you must change the values in 
BRU64K. Do this by using the following CNF switches when you 
enter the device name: 


/CSR=csr address 
/VEC=vector address 
/EOR=formatter number 


For example, assume that your first disk device (the one 
containing RSXM38) is at nonstandard CSR and vector addresses 
of 176714(octal) and 300(octal), respectively, and your 
output disk device has the default addresses. Assuming that 
the unit numbers of both units are zero and one, 
respectively, the following is the sequence of commands to 
CNF: 


Enter first device:DL0: /CSR=176714/VEC=300 (RED 

Enter second device:DL1: @é) 
Press RETURN, then enter the date and time using the TIME 
command. Use the TIME command again to verify that you 
entered the correct date and time. For example: 


Hit RETURN and enter date and time as 'TIM HH:MM MM/DD/YY' 


>TIM 14:32 05/25/85 


>TIM 
14:32:01 25-MAY-85 
> 


Run the Bad Block Locator Utility (BAD) on the RSXM38 _ blank 
disk. For example, if your output device is DL1l:, use the 
following command sequence: 


>RUN BAD 


BAD> DL1:/LIST 


BAD -- DL1l: Total bad blocks= 0. 
BAD > CiRtiz) 
> 


The BAD /LIST switch lists any bad blocks as they are 
located. 


Run the Backup and Restore Utility (BRU) to copy the RSXM38 
distribution kit disk to the RSXM38 output disk. 


For example, if your output device is DL1:, use the following 
command sequence: 


>RUN BRU 


BRU>/INI/VER 
From: DLO: 
To: DLL: 
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The BRU /INI (initialize) switch initializes the disk volume 


to which BRU is copying. (Be aware that if there are any 
files on the disk, they will be deleted.) 


The BRU /VER (verify) switch causes BRU to verify the data 
after it is copied. BRU issues the following message 
indicating that it has begun to verify the data copied: 


BRU - Starting verify pass 


NOTE 


If the verify fails, do not attempt’ the 
system generation without first retrying the 
backup operation. If the verify fails again, 
retry the backup operation using a new output 
disk. If the verify fails once again, it is 
likely that either your distribution kit is 
defective and should be replaced or your 
hardware needs to be checked. 


ll. When the distribution disk is successfully copied, BRU issues 
the following message to indicate that it has finished: 


BRU - Completed 


BRU> Ciai/Z) 
> 


Spin down both disks and remove them. Replace the 
distribution disk with the next distribution disk. Replace 
the new disk copy with the next blank disk, and spin up both 
disks. 


NOTE 


When copying the distribution disks, it is a 
good idea to write-protect the disk from 
which you are copying data. To do this, 
press the write-protect button on the face of 
the disk drive. 


12. Repeat Steps 9 to 11 with the rest of the disk volumes in the 
-distribution kit. 


NOTE 


The following warning message from BRU 
reminds you that the other disks being copied 
cannot be hardware bootstrappped: 


BRU - This disk will not contain a hardware bootable system 


Only the baseline disk is hardware-bootable 
in the RLOl and RLO2 distribution kits. 
Therefore, the warnings appear when BRU is 
copying all but the baseline disk (RSXM38). 
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At this point, you have completed the disk-to-disk copy of the 
distribution kit and are ready to bootstrap the baseline system again 
and generate your RSX-11M system. Refer to Appendix B for information 
on bootstrapping your baseline disk. Then turn to Chapter 3 for 
details on the structure of SYSGEN. It is important that you read 
Chapter 3 before you begin generating your system. 


2.3.2 Copying Kits On-Line 


This section describes the procedures that you use to copy each type 
of distribution kit using an on-line host computer. The host computer 
can be running under the control of an RSX-11M or RSX-11M-PLUS 
operating system, or it can be a VAX/VMS computer operating in VAX-11 
RSX compatibility mode. This section discusses procedures for a host 
computer running RSX-11M. Refer to Section 2.5.1 for instructions on 
using a host computer that is running RSX-l11M-PLUS. Refer to Section 
2.5.2 for instructions on using a host computer that is running VAX-11 
RSX. 


If you have a magnetic tape kit, read Section 2.3.2.1 next. 
If you have an RKO06/07 disk kit, read Section 2.3.2.2 next. 


If you have an RLO1/02 disk kit, read Section 2.3.2.3 next. 


2.3.2.1 Copying the Magnetic Tape Kit On-Line - Use the following 
procedure to copy the 1600 bpi or 800 bpi tape kit or the 6667. You 
must use the disk copy of the distribution kit to generate an RSX-11M 
system. The tape kit may serve as the permanent backup copy. The 
term “output disk" or "blank disk" in this section refers to the blank 
disk that you are using as the target system disk. 


You will need one to seven blank disks to copy the distribution kit, 
depending on the type of kit that you have. Place a physical label on 
the first disk so the blank disk represents the backup set name in the 
distribution kit (RSXM38). If the disk you intend to copy to is an 
RA80/RA81, RC25, RD52/RD53, or RM80 disk, the fixed disk is the blank 
disk. The type of blank disk you use must be compatible with your 
distribution kit. If your blank disk is a fixed-media disk, that disk 
cannot be the disk that the current system is running on. 


You should format removable-media blank disks (using the FMT utility) 
and check either fixed- or removable-media blank disks for bad blocks 
(using the BAD utility) before copying the distribution kit to them. 
Refer to the RSX-11M/M-PLUS Utilities Manual for details on using BAD 
and FMT. 


To copy your distribution tapes to disk using an on-line’ system, 
perform the following steps: 


1. If you are using a multiuser system, allocate the appropriate 
disk and tape drives for the media to be used. For example, 
if you load your distribution tape on a TU16 magnetic tape 
drive and you plan to copy the tapes to an RKO7 disk, 
allocate the devices as follows: © 


>ALL DMO: 
>ALL MMO: 
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Load and mount the distribution kit tape labeled RSXM38 on 
the tape drive. 


Load the blank disk, which you have previously labeled 
RSXM38, in the drive and spin up the disk. If your big-disk 
media is an RA80/RA81, RC25, RD52/RD53, or RM80 disk (all 
fixed-media disks), the fixed-media disk serves as the blank 
disk. 


NOTE 


The disk volume should not be mounted yet. 
If the disk is mounted as a Files-1ll device, 
BRU will issue the following warning message: 


BRU ~- *FATAL* - Privilege violation 


You are now ready to copy the distribution tape to the disk. 
Invoke the Backup and Restore Utility (BRU), using the 
following command line: 


>BRU/REW/INI/DEN:density/BAC:name mmn: ddn: 


The switches and parameters in the BRU command line have’ the 
following functions: 


a. The /REW (rewind) switch ensures that the tape is 
completely rewound before BRU begins to copy. 


b. The /INI (initialize) switch initializes the disk volume 
to which BRU is copying. (Be aware that if there are any 
files on the disk, they will be deleted.) 


c. The /DEN (density) switch specifies the density (bpi) at 
which the tape was written. 


d. The /BAC (backup _set) switch identifies the BRU backup 
set that you want to copy. A backup set is the unit of 
data that is directed to or from a volume with a_ single 
BRU command line (during a single backup or restore 
operation). The distribution tape consists of a series 
of BRU backup sets, all or some of which are copied to 
the target system disk, depending on which type of disk 
you are copying to. Each type of disk has a name that 
you use with the /BAC switch to identify it. The 
following list shows the name for each type of disk: 


Disk Type Name 
RPO04/RP05/RP06 DBSYS 
RLO1/RLO2 DLSYS 
RKO6/RK07 DMSYS 
RMO02/RM03/RM05/RM80 DRSYS 
RA60/RA80/RA81/RC25/RD52/RD53 DUSYS 


e. The mmn: specification identifies the tape device and 
unit that you are copying from. 
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f. The ddn: specification identifies the disk device and 
unit that you are copying to. 


For example, to begin copying the tape labeled RSXM38 
(mounted on device MMO0:) to an RKO7 disk, issue the following 
command: 


BRU>/REW/INI/DEN: 1600/BAC:DMSYS MM: DMO: 
BRU - Starting Tape 1 on MMO: 

BRU - End of Tape 1 on MMO: 

BRU - Completed 


In response to your command, BRU copies the backup set named 
DMSYS from the tape and displays a message when the copy 
operation has been completed. 


You have now copied the backup set for the type of disk you 
are copying to. This backup set includes an indirect command 
file named TAPEKIT.CMD that will copy the remainder of the 
distribution kit to the disk for you. The remaining steps in 
this procedure show you how to invoke the TAPEKIT command 
file. 


Mount the disk that you have copied from the distribution 
tape, then copy the TAPEKIT command file from directory 
[200,200] to your directory, using the following command 
sequence (in the example, the disk is mounted on DMO0:): 


>MOU DMO: RSXM38 @ED. 
>PIP /NV=DM1: [200,200] TAPEKIT.CMD (ED) 


Invoke the TAPEKIT command procedure (by issuing the command 
@TAPEKIT), and answer the questions that TAPEKIT displays. 
The example that follows the note below shows the process 
that TAPEKIT conducts in order to copy the remaining backup 
sets from the distribution kit to the disk. 


NOTE 


If the recording density of the tapes in your 
kit is 800 bpi, TAPEKIT will display a 
message to notify you when it is time to 
mount the second tape. TAPEKIT then copies 
the contents of the second tape to your disk. 
If the copy operation fails, TAPEKIT displays 
a message to notify you of the failure. In 
such a case, retry the copy operation. If 
the copy fails again, retry the procedure 
using a different output disk. If the copy 
still fails, it is likely that either your 
distribution kit is defective and should be 
replaced, or your hardware needs to be 
checked. 
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The following is an example of the TAPEKIT procedure, using an RKO7 
disk: 


>@TAPEKIT 


; RSX-11M V4.2 BL38 tape distribution kit extraction procedure 
. Started on 26-MAY-85 at 18:51:05 


>* Enter device and unit for disk(s) [ddn:] [s] :DM: QED 
>* Enter disk type, RKO6 or RKO7 [D:RK0O7]} [S]:eD 


>* Enter drive and unit with tape distribution kit [ddn:] [S]:MM: @eD 
>* Density: [D:1600]) [S]:@ED 


; Copying rest of RSXM38 to DM: ... 


tA 
>BRU/DENS: 1600/NOINI/SUP/UFD/BAC:RSXBAS MMO: DM: 
BRU ~ Starting Tape 1 


BRU ~— End of Tape l 
BRU - Completed 


>BRU/DENS: 1600/NOINI/SUP/UFD/BAC:EXCPRV MMO: DM: 
BRU - Starting Tape l 


BRU —- End of Tape 1 


BRU - Completed 


>; Completed on 26-MAY-85 at 19:02:07 


Note that BRU will display a message for each of the volumes that it 
copies from the distribution tape. 


At this point, you have completed the tape-to-disk copy and are ready 
to generate your RSX-11M system. Before you begin generating your 
system, it is important that you read Chapter 3 for details on _ the 
structure of SYSGEN. 


2.3.2.2 Copying the RKO6/RKO7 Disk Kit On-Line - Use the following 
procedure to copy the RKO06/07 disk kit using the host computer on 
line. The term "output disk" or "blank disk" in this section refers 
to the blank disk that you are using as the target system disk. 


You will need one blank disk to copy the RKO7 distribution kit, and 
two blank disks to copy the RK06 distribution disk. (Place a physical 
label on each disk so that the blank disks represent the labels on the 
respective disks in the distribution kit.) 
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You should format the blank disks (using the FMT utility) and check 
them for bad blocks (using the BAD utility) before copying the 
distribution kit. Refer to the RSX-11M/M-PLUS Utilities Manual for 
details on using BAD and FMT. 


To copy your distribution disk using an on-line system, perform the 
following steps: 


l. If you are using a multiuser system, allocate the appropriate 
disk drives for the media to be used. For example, allocate 
the devices as follows: 


>ALL DMO: GED 
>ALL DM1: 


2. Load the distribution disk labeled RSXM38 in DMO:; then load 


the blank disk labele@ RSXM38 in DMl:, and spin up both 
‘disks. 


NOTE 


The disk volume should not be mounted. If 
the disk is mounted as a Files-1l device, BRU 
will issue the following warning message: 


BRU - *FATAL* -— Privilege violation 


When copying the distribution disks, it is a good idea to 
write-protect the disk from which you are copying data. 


3. Invoke the Backup and Restore Utility (BRU) and enter. the 
command line to copy the disk. For example, enter the 
following command line to BRU: 


>BRU 

BRU>/INI/VER @ED 
From: DMO: 
To: DM1: 


The BRU /INI (initialize) switch initializes the disk volume 
to which BRU is copying. (Be aware that if there are any 
files on the disk, they will be deleted.) 


The BRU /VER (verify) switch causes BRU to verify the data 
after it is copied. BRU issues the following message to the 
terminal indicating it has begun to verify the data copied: 


BRU - Starting verify pass 


NOTE 


If the verify fails, do not attempt the 
system generation without first retrying the 
backup operation. If the verify fails again, 
retry the backup operation using a new output 
disk. If the verify fails once again, it is 
likely that either your distribution kit is 
defective and should be replaced or your 
hardware needs to be checked. 
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When the distribution disk is successfully copied, BRU issues 
a message at your terminal to indicate that it has finished: 


BRU - Completed 
> GIRLZ) 
> 


4. If you have an RKO7 distribution disk, the copying process is 
now completed. If you have an RKO6 distribution kit, spin 
down both disks and remove’ them. Replace the first 
distribution disk with the second one, labeled CLISRC. 
Replace the new copy of RSXM38 with the second blank disk, 
and spin up both disks. Again, write-protect the disk from 
which you are copying data. Then repeat Steps 2 to 4 of this 
procedure with the CLISRC disk. 


NOTE 


The following warning message from BRU 
reminds you that the second disk being copied 
cannot be hardware bootstrapped: 


BRU - This disk will not contain a hardware bootable system 


You can hardware bootstrap the baseline disk 
only (the disk labeled RSXM38). 


At this point, you have completed the disk-to-disk copy of the 
distribution kit and are ready to generate your RSX-11M system. 
Before you begin generating your system, it is important that you read 
Chapter 3 for details on the structure of SYSGEN. 


2.3.2.3 Copying the RLO1/RLO2 Disk Kit On-Line - Use the following 
procedures to copy the RLO1 or RLO2 disk kit using a host computer on 
line. The term "output disk" or "blank disk" in this section refers 
to the blank disks that you are using as the target system disks. All 
commands shown in this section are issued to the RSX-11S Basic MCR 
command line interpreter. 


The RLO1 kit consists of seven disks. The RLO2 kit consists of only 
five disks because two RLO2 disks contain the contents of two RLO1 
disks. The disk labels and contents are: 


RLO1L RLO2 
Disk Label Disk Label RLO1 Volume (s) 
RS XM38 RS XM38 RS XM38 
EXCPRV EXCPRV EXCPRV 
PRVBLD PRVBLD PRVBLD, RLUTIL 
RLUTIL MCRSRC MCRSRC, HLPDCL 
MCRSRC RMSV20 RMSV20 
HLPDCL 
RMSV20 


You will need seven blank RLO1, or five blank RLO2, disks to copy the 
entire distribution kit. (Place a physical label on each disk so that 
the blank disks represent the volume names in the distribution kit.) 
However, only the first four volumes (RSXM38, EXCPRV, PRVBLD, and 
RLUTIL) are used during a system generation. See 
post-system-generation guidelines in Chapter 6 to determine whether or 
not you need to copy the remaining backup sets. 
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You should check the blank disks for bad blocks (using the BAD 
utility) before copying the distribution kit to it. Refer to the 
RSX-1L1M/M-PLUS Utilities Manual for details on using BAD. 


To copy your distribution kit on an on-line system, perform the 
following steps: 


l. If you are using a multiuser system, allocate the appropriate 
disk drives for the media to be used. For example, allocate 
the devices as follows: 


>ALL DLO: 
>ALL DL1: 


2. Load the distribution disk physically labeled RSXM38 in DLO:, 
then load the blank disk, labeled RSXM38, in DL1l:, and spin 
up both disks. 


NOTE 


The disk volume should not be mounted. If 
the disk is mounted as a Files-1ll device, BRU 
will issue the following warning message: 


BRU - *FATAL* - Privilege violation 


When copying the distribution disks, it is a good idea to 
write-protect the disk from which you are copying data. 


3. Invoke the Backup and Restore Utility (BRU) and enter the 
command line to copy the disk. For example, enter the 
following command line to BRU: 


>BRU QED 

BRU>/INI/VER 
From: DLO: 
To: DL1: 


The BRU /INI (initialize) switch initializes the disk volume 
to which BRU is copying. (Be aware that if there are any 
files on the disk, they will be deleted.) 


The BRU /VER (verify) switch causes BRU to verify the data 
after it is copied. BRU issues the following message 
indicating that it has begun to verify the data copied: 


BRU - Starting verify pass 


NOTE 


If the verify fails, do not attempt the 
system generation without first retrying the 
backup operation. If the verify fails again, 
retry the backup operation using a new output 
disk. If the verify fails once again, it is 
likely that either your distribution kit is 
defective and should be replaced or your 
hardware needs to be checked. 
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4. When the disk is successfully copied and verified, BRU issues 
the following message: 


BRU - Completed 


Spin down the disks and remove them. Replace the 
distribution disk with the next one to be copied. Replace 
the new disk copy with the next blank disk. Spin up both 
disks again remembering to write-protect the disk from which 
you are copying data. 


5. Enter the command line to BRU to copy the next distribution 
disk: 


BRU> /INI/VER 
From: DLO: 
To: DLL: 


The following warning message from BRU reminds you that’ the 
disk being copied is not hardware-bootable: 


BRU - This disk will not contain a hardware bootable system 


Only the baseline disk is hardware-bootable in the RLO1/02 
distribution kit. Therefore, the warnings appear when BRU is 
copying all but the baseline disk (RSXM38). 


When the disk is successfully copied, BRU returns’ the 
following messages to indicate that it has finished: 


BRU - Starting verify pass 
BRU - Completed 


You may then unload the distribution disk and the new disk 
backup set. 


6. To copy the remaining distribution disks, repeat steps 4 and 


5 with each remaining distribution disk you need to copy for 
your SYSGEN. 


7. To exit BRU after you have finished copying all the backup 
sets you need, type CTRL/Z in response to BRU prompt. 


At this point, you have completed the disk-to-disk copy of the 
distribution kit and are ready to generate your RSX-11M system. 
Before you begin generating your system, it is important that you read 
Chapter 3 for details on the structure of SYSGEN. 


2.4 THE UPDATE PROCEDURE 


This section describes how you use an Update package to apply 
corrections to your RSX-11M Version 4.2 operating system and layered 
products software. 


The Update package consists of two groups of software: the Update kit 
and the layered product files. Depending on which type of Update 
package you receive, the two groups of software are supplied on one or 
two pieces of magnetic media. 
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The Update kit is a set of files that you use to apply corrections to 
your operating system software. These corrections are cumulative, 
that is, each Update contains all of the corrections that have been 
generated since the release of RSX-11M Version 4.2. Included in the 
Update kit is an interactive command procedure that applies the Update 
files to your current operating system software. 


You use the layered product files to apply corrections to some of the 
layered products (such as languages and DECnet) that run on RSX-11M. 


NOTE 


If you are installing an RSX-11M system for the first 
time, you must apply your Update package before you 
invoke the SYSGEN procedure to generate your operating 
system. 


2.4.1 The Update Package 
Your Update package is one of the following types: 
@ Magnetic tape kit (800 or 1600 bpi) 
@ RKO6/RKO7 disk kit 
@ RLO1/RLO2 disk kit 
e TK50 magnetic tape cartridge kit 


RKO6/RKO7 and RLO1/RLO2 Update packages are distributed on magnetic 
tape or disk media. Update packages targeted for all other types of 
disks are distributed on magnetic tape only. 


The software in the Update package falls into the following three 
categories: 


@ Update procedure command file - the indirect command fils that 
controls the Update command procedure 


e Replacement files - the updated or new object modules’~ that 
replace the object module files on your RSX-11M distribution 
kit 


e Correction files - the files (.COR file type) that were used 
to create the updated source files (.MAC file type) that are 
applied during the Update command procedure 


The layered product files are used to apply corrections to certain 
layered products that run on RSX-11M. For a list of the layered 
product files and instructions on how to use them, see the RSX-11M 
Update Notes that are included with each Update. ——— 


2.4.2 How Update Works 


Update is the name of a command procedure that applies corrections to 
your RSX-11M Version 4.2 operating system software. 


The Update command procedure copies the replacement files in the 
update software to a disk containing a copy of your RSX-11M Version 
4,2 distribution kit. Then you use the disk containing the updated 
distribution kit to generate a new RSX-11M system. 
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The Update kit is cumulative. Therefore, each revision of the Update 
kit contains all of the corrections that have been generated since the 
last full release of RSX-11M. 


You must apply this Update to an unaltered copy of the RSX-11M Version 
4.2 distribution kit. Otherwise, the corrections will not be properly 
integrated with the other system software components, so your system 
will not work. 


2.4.2.1 The Update Command Procedure - An indirect command file named 
UPDATE.CMD is contained in UFD [200,200] on the baseline disk (the 
disk labeled RSXM38) in your original RSX-11M Version 4.2 distribution 
Kits This indirect command file initiates the application of the 
Update procedure. When you begin the Update procedure by invoking 
UPDATE.CMD, the file UP.CMD is copied from the Update kit medium to a 
disk that contains a copy of your RSX-11M Version 4.2 distribution 
kit. UPDATE.CMD invokes UP.CMD, which then copies the replacement 
files (new files that replace the original object modules and _ source 
files) to your distribution kit disk. When the copying has been 
completed, the Update has been applied and you have a target system 
disk that contains all of the files necessary to generate an updated 
RSX-11M operating system. You then invoke the SYSGEN procedure to 
generate the updated system. 


NOTE 


Please note that questions asked by the Update command 
procedure vary according to your distribution kit. 


2.4.2.2 Replacement Files - The replacement object files (.OBJ file 
type) are the updated files that incorporate the latest corrections to 
your RSX-11M system. The Update command procedure copies’ these 
replacement files to your target system disk. Then, when you perform 
a new system generation, you create an updated system that contains 
the corrections and new software features supplied in the Update. 


2.4.2.3 Source Correction Files - The Update kit also contains’ the 
source correction files (.COR file type) that were used to create some 
of the replacement files used by the Update procedure. The .COR files 
are included to provide documentation of the changes that the Update 
has made to those portions of the system software for which MACRO-11 
source code is supplied on the RSX-11M Version 4.2 distribution kit. 
Generally, you do not need these files. However, if your application 
warrants it, you may edit the correction files to include your own 
corrections. You can then apply the edited correction files manually 
to produce updated source files. 


2.4.3 Preparing for Update 

This section describes the necessary preparations for the Update 
procedure. Before you apply the Update package software, you must 
create a disk copy of the original, unaltered RSX-11M Version 4.2 
distribution kit. This must not be a copy on which you have run the 
SYSGEN command procedure, but a copy made directly from your original 
RSX-11M Version 4.2 distribution kit. Copying your distribution kit 
to disk ensures that you will have an original, unaltered distribution 
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kit to recopy if media or hardware problems occur during the Update 
command procedure. Refer to Section 2.3 for instructions on how to 
copy your distribution kit. In this section, the term "target system 
disk" refers to the disk that you are copying the distribution kit to. 


2.4.3.1 Hardware Required for Applying Update - Hardware requirements 
differ according to the type of media in your distribution kit and 
Update package. If you have a magnetic tape distribution kit for any 
of the supported target system disks except for RKO6/RKO7 or RLO1/RLO2 
disks, you need one magnetic tape drive and one disk drive of the same 
type as your target system disk. 


If you have an RKO6/RKO0O7 or RLO1/RLO2 disk distribution kit and a 
Magnetic tape Update kit, you need one magnetic tape drive and two 
RKO6/RKO7 or RLO1L/RLO2 disk drives. 


If you have an RKO6/RKO7 disk distribution kit and an RKO6/RKO7 disk 
Update kit, you need two RKO6/RK07 disk drives. 


If you have an RLOI1/RLO2 disk distribution kit and an RLO1/RLO2 disk 
Update kit, you need two RLO1/RLO2 disk drives. 


2.4.4 Applying Update 


After you have made a copy of the distribution kit, you apply the 
Update software to the distribution kit files. You can apply Update 
' either on an on-line host computer, or on a Stand-alone host computer. 


If you have access to a system already running an on-line system, you 
can use that system to apply Update on line. An on-line system is one 
on which other activity may be occurring and on which other users may 
be logged in. The Update procedure executes on an RSX-11M, 
RSX-1LIM-PLUS, or VAX-11 RSX on-line host computer. 


If you do not have access to a system already running RSX-11M, you 
must use the baseline system on the RSX-11M distribution kit to apply 
Update to a stand-alone system. A stand-alone system runs the RSX-11M 
baseline system, which dedicates your host computer's resources to 
your application alone. 


If you are applying an Update for the first time, you should. read 
Chapter 1, this chapter, and the RSX-11M Update Notes before you 
invoke the Update procedure. If you understand the Update and system 
generation procedures before you begin them, you will be better 
prepared to avoid mistakes, and you can do a better job of tailoring 
your system to suit your particular needs. 


The following sections provide general instructions for applying 
Update on either type of host. In addition to reading the following 
sections, refer to the applicable version of the RSX-11M Update Notes 
for instructions specific to each Update. 
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2.4.4.1 Applying Update Stand-Alone - Follow the procedure in this 
section to apply your Update package using a stand-alone host: 


1. Load the Update kit disk or tape on an appropriate drive. 
Load the distribution kit baseline disk, (the disk labeled 
RSXM38), on an appropriate drive. Then hardware bootstrap 
the distribution kit disk labeled RSXM38. For example: 


>; 

RSX-11M V4.2 BL38 124K MAPPED (BASELINE) 

>; 

>RED DL:=SY: 

>RED DL:=LB: 

>MOU DL:RSXM38 (ED 

>@DL: [1,2] STARTUP 

>* PLEASE ENTER TIME AND DATE (HR:MN DD-MMM-YY) [S]: 18:34 17-JUN-85 


>TIM 18:34 17-JUN-85 @ED 
>* ENTER LINE WIDTH OF THIS TERMINAL [D:132.]}: 


>SET /BUF=TI:132 
>ACS SY:/BLKS=512 


>@ <EOF> 
> 


2. Invoke the Update command procedure, by issuing the following 
command: 


> @UPDATE @ED 


3. Answer the questions and follow the instructions that the 
Update procedure displays. If this is Update A, (the Update 
distributed with the initial release of RSX-11M Version 4.2), 
Update only displays a notification of corrections to layered 
products. There are no corrections to the base system 
software. 


If this is not Update A, the Update will proceed with the 
following steps. 


4. If the Update kit is on magnetic tape, the correction files 


must be copied to disk before they can be applied to the 
distribution kit disks. 


If the distribution kit is on an RKO6/RKO7 or an RLOL/RLO2, a 
backup set is copied to a blank disk of the same type. 


If the distribution kit is on a disk other than an RKO0O6/RKO7 
or an RLO1/RLO2, a backup set is copied directly to the 
distribution disk. 


5. The Update procedure applies’ the corrections to the 
distribution kit. 


If the distribution kit is an RKO6/RKO7 or an RLOI/RLO2, the 
disk with the Update files is software booted and the 
correction files are applied to the distribution kit. 


If the distribution kit is on a disk other than an RKO6/RKO07 
or an RLO1/RLO2, the correction files are applied in place to 
the distribution kit. 
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The following is an example of an Update A procedure on a_ stand-alone 
host: 


> 
> 
>@UPDATE 


; RSX-11M V4.2 UPDATE PROCEDURE 17-JUN-85 18:34:11 


; This command file initiates the Update Procedure for RSX-11M V4.2. It 

+ will determine what type of Update media is being used as well as what 

; Update level is being applied. It will copy all of the files that are 

; necessary to bring your system up to the current patch level. The 

; destination of these files will be determined from what type of Update 
>; media you are using and what Update level you are applying. When this 
>; copying is complete and the Update has been applied, it may be necessary 
>; to perform a SYSGEN to incorporate the new software. 


, 
>INS LB: SBRU 
>; 
>* Enter device and unit for update kit [ddn:] [S]:MmM: RED 
>* Density [D:1600] [S]: @eD 
>: 
>’ LOA MM: /PAR=GEN 
>; 
>* Enter device containing distribution kit [ddn:] [S]:pDL: ED 
>} 
>BRU/NOINI/SUP/UFD/DENS:1600/REW MM: [1,11] DL: 
BRU - Starting Tape 1 on MMO: 


BRU - End of Tape 1 on MMO: 


BRU - Completed 
a 
>; RSX-11M V4.2 UPDATE A 


>; There are no updates to the RSX-11M software on this version of 
: the Update kit. However, this Update kit contains corrections 
>; for the following layered products: 


>; DECnet-11M V4.0 
3; DPM V4.1 
; FMS-11/RSX V1.0 
3 PDP-11 FORTRAN-IV V2.6 
>; KMV11-A HDLC Framing Software V1.0 
; DCX KMV11-A Development Tools V1.0 
>; RSX-11 2780/3780 Protocol Emulator V4.1 
3; PDP-11 COBOL V4.4 
; COBOL-81/RSX V2.3 
>; DATATRIEVE-11 V3.1 
>: PDP-11 FORTRAN-77/RSX V5.0 
>; PDP-11 FORTRAN-77 DEBUG/RSX V1.0 
>; PDP-1l1 PASCAL/RSX V1.1 
; PDP-11 SORT/MERGE V3.0 


>; Please read the documentation included in the 
>; RSX-11M System Generation and Installation Guide 
>; for directions on applying these Updates. 


; Application of the Update is complete. A record of this 
; will be appended to the KITIDENT file. 


’ 
>SET /UIC=[200, 200] 
>@ <EOF> 
> 


2.4.4.2 
section 


1. 
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Applying Update On-Line - Follow the procedure in this 


to apply your Update using an on-line host: 


Log into a privileged account and set your command line 
interpreter to MCR. For systems other than RSX-11M, refer to 
section 2.5 for the requirements necessary for running 
Update. 


Load the Update kit disk or tape on an appropriate drive. 
Load the distribution kit baseline disk, (the disk labeled 
RSXM38), On an appropriate drive. 


Allocate and mount the baseline disk labeled RSXM38, by 
issuing the following command sequence: 


>ALL DRO: 
>MOU DRO:RSXM38 


Copy the Update command procedure named UPDATE.CMD from 
directory [200,200] to your directory: 


>PIP /NV=DRO: [200, 200] UPDATE.CMD 


Invoke the Update command procedure by issuing the following 
command: 


>@UPDATE 


Answer the questions and follow the instructions that the 
Update procedure displays. If this is Update A, (the Update 
distributed with the initial release of RSX-11M Version 4.2), 
Update only displays a notification of corrections to layered 
products. There are no corrections to the base system 
software. 


If this is not Update A, the Update will proceed with the 
following steps. 


If the Update kit is on magnetic tape, the correction files 
must be copied to disk before they can be applied to the 
distribution kit disks. 


If the distribution kit is on an RKO6/RKO07 or an RLOI/RLO2, a 


backup set is copied to a blank disk of the same type and the 
disk is mounted. 


If the distribution kit is on a disk other than an RKO6/RKO7 
or an RLO1L/RLO2, a backup set is copied directly to the 
distribution disk. 


If the Update kit is on an RKO6/RKO7 or an RLOL/RLO2, the 
disk is mounted. 


The Update procedure applies’ the corrections to the 
distribution disk(s). 


If the distribution kit is an RKO6/RKO07 or an RLOL/RLO2, the 
disk with the Update files is mounted and the correction 
files are applied to the distribution kit from the Update 
disk. 


If the distribution kit is on a disk other than an RKO6/RKO7 
or an RLO1/RLO2, the correction files are applied in place to 
the distribution kit. 
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The following is an example of an Update A procedure on an on-line 
host: 


> 
> 
>@UPDATE 


>; RSX-11M V4.2 UPDATE PROCEDURE 17-JUN-85 18:34:11 


>; This command file initiates the Update Procedure for RSX-11M V4.2. It 

; will determine what type of Update media is being used as well as what 

; Update level is being applied. It will copy all of the files that are 
>; necessary to bring your system up to the current patch level. The 

; destination of these files will be determined from what type of Update 
>; media you are using and what Update level you are applying. When this 
>; copying is complete and the Update has been applied, it may be necessary 
>; to perform a SYSGEN to incorporate the new software. 


>* Enter device and unit for update kit [ddn:] [S]:MM: @ED 
>* Density [D:1600] [S]: GED 


>* Enter device containing distribution kit [ddn:] [S]:DL: @é 
>} 

>BRU/NOINI/SUP/UFD/DENS:1600/REW MM:[1,11] DL: 

BRU - Starting Tape 1 on MMO: 


BRU - End of Tape 1 on MMO: 


BRU - Completed 


>; RSX-11M V4.2 UPDATE A 


; There are no Updates to the RSX-11M software on this version of 
; the Update kit. However, this Update kit contains corrections 
>; for the following layered products: 


>; DECnet-11M V4.0 
; DPM V4.1 
; FMS-11/RSX V1.0 
; PDP-11 FORTRAN-IV V2.6 
>; KMVL1-A HDLC Framing Software V1.0 
; DCX KMV11-A Development Tools V1.0 
7 RSX-11 2780/3780 Protocol Emulator V4.1 
; PDP-11 COBOL V4.4 
>; COBOL-81/RSX V2.3 
>; DATATRIEVE-11 V3.1 
; PDP-11 FORTRAN-77/RSX V5.0 
>; PDP-11 FORTRAN-77 DEBUG/RSX V1.0 
>; PDP-11 PASCAL/RSX V1.1 
; PDP-11 SORT/MERGE V3.0 


; Please read the documentation included in the 
; RSX-11M System Generation and Installation Guide 
>; for directions on applying these Updates. 


; Application of the Update is complete. A record of this 
; will be appended to the KITIDENT file. 

3 

>SET /UIC=[200, 200] 

>@ <EOF> 

> 
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2.4.5 Errors During Update 


There are some errors from which Update attempts to recover, such as 
- the inability to mount a disk. When such an error is encountered, 
Update displays an error message and a list of options from which you 
can choose the action you want Update to take. 


The following is an example of the text that the Update procedure 
displays if a recoverable error occurs: 


An error has occurred that prevents the Update procedure from 
working correctly. 


If you know what caused the error, correct the error, then 
either continue with the Update procedure or abort the Update 
procedure and begin again. 


See the RSX-11M System Generation and Installation Guide 
for more information on identifying and correcting errors. 


You may choose one of the following options: 


A - > Abort and exit from the Update procedure 

C - > Continue with the Update procedure without 
repeating the command that caused the error 

P - > Pause while you attempt to resolve the problem 

R - > Repeat the command that caused the error 


Which option do you choose (A, C, P, or R)? [S] 


If you choose option A, Update dismounts the target system disk and 


exits. 


Choose this option if you do not understand the circumstances 


surrounding the error and you wish to terminate the Update procedure. 


If you choose this option, Update prints the following messages on 
your terminal: 

>} 

>; Refer to the instructions in the RSX-11M System Generation and 
; Installation Guide for installing this Update kit to make certain 
7 you have not skipped a step or overlooked something. 
; 
; If you cannot identify and resolve the problem, please contact 

>; your local DIGITAL software specialist for further assistance. 
; 

>TIM 

17:09:31 12-JUN-1985 

3 

>; Now dismounting the Update kit device and exiting... 

>3 

>DMO MM: 

DMO -- TT36: dismounted from MMO: ***Final dismount initiated *** 

>} 

>SET /UIC=[200, 200] 

>@<EOF> 

> 


If you choose option C, Update continues with the next command = and 


ignores 


the error. You might choose this option if the Update 


procedure's attempt to mount the Update kit disk failed because’ the 
kit disk was already properly mounted. 
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If you choose option P, the Indirect Command Processor pauses until 
you instruct it to continue by issuing the UNS command. You might 
choose this option if mounting the Update kit failed because you had 
the kit mounted, but not properly for Update, and you want to dismount 
the kit and then have Update reissue the MOUNT command. When you 
restart the Indirect Command Processor by using the UNS command, the 
option question is repeated so that you may choose either option C or 
option R. 


The following is the text that Update prints when you use the "p" 
command to pause: 


>i 

>; The Update procedure will now pause to let you attempt to 

>; resolve the problem. Please UNStop the indirect command file 
>; processor when the problem has been resolved. 


>7 
AT.TO -- Pausing. to continue type "UNS AT. €s0" 
If you choose option R, Update repeats the command that failed. You 


might choose this option if mounting the Update kit failed because you 
specified a device that did not contain the Update kit, but the kit is 
now ready to be read from the specified device. 


2.4.6 Layered Product Files 


The Update package also includes files to update certain layered 
products. 


In the magnetic tape Update packages, the layered product files are on 
the Update tape in the form of additional backup sets. In the 
RKO6/RKO7 and RLO1/RLO2 disk Update packages, the layered product 
files are in directories on the Update disk. 


There is a documentation file (.DOC file type) for each layered 
product that explains how to apply the corrections to that layered 
product. Read the documentation files for each layered product that 
you have on your system. 


You should apply any corrections to layered products after you use the 
SYSGEN procedure to generate a new system that incorporates the Update 
corrections. The layered products require the corrected versions of 
certain files (for example, SYSLIB.OLB) that are produced during the 
system generation procedure. 


2.4.6.1 Accessing the Corrections with the Magnetic Tape Package - If 
you have the magnetic tape Update package, the files for each product 
are contained in a separate BRU backup set on the Update kit tape. 
You must restore the backup set from the tape to the disk before you 
can apply the layered product files. Use the BRU utility to restore 
the backup set to disk, and then type or print the appropriate 
documentation file for further instructions. You can display an 
instruction file at your terminal by using the following command line: 


>PIP T1:=ddnn: [ggg, 200] product.DOC (ED 


In the above command line, replace ddnn: with the name of the drive 
that contains the Update kit and replace ggg with the group number 
from the directory specification for the file that you want to display 
(as listed in the RSX-11M Update Notes). 
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The following description shows you how to restore the BRU backup set 
for PDP-11 FORTRAN-77/RSX. The backup set name for FORTRAN-77/RSX is 
F77. For other layered products, substitute the applicable backup set 
name. 


To restore a backup set, mount the Update software contained on 
magnetic tape. For example, if the Update magnetic tape is loaded on 
drive MMO: and the disk to which you want to copy the FORTRAN-77 
backup set to is the device DMO: (an RKO7 mounted as a Files-1l 
volume), use the following MCR command string: 


>MOU /FOR MMO: @éED) 
>BRU /NOINI/UFD/DENS:1600/SUP/REW/BAC:F77 MMO: DMO: @éD 


If you have the Update software contained on an 800 bpi magnetic tape, 
substitute /DENS:800 for /DENS:1600 in the command string above. 


2.4.6.2 Accessing the Corrections on the RKO6/RKO7 or RLO1/RLO02 
Update Package ~- If you have the RK0O6/RKO07 or RLO1L/RLO2 disk 
Update package, mount the Update disk as a Files-l1l volume and type or 
print the appropriate documentation file. You can display a 
documentation file at your terminal using the following command line: 


>PIP TI:=ddnn: [ggg,200] product.DOC 


When you issue the above command line, replace ddnn: with the name of 
the drive that contains the Update disk, and replace ggg with the 
group number of the directory specification for the file that you want 
to display (as listed in the RSX-11M Update Notes). 


You can also copy the contents of selected directories to disk by 
creating the necessary directories using the MCR UFD command, and then 
using PIP. For example, if you want to copy the contents of UFD 
[252,200] from an RKO7 Update disk mounted on DMl: to your system 
disk mounted on DM0:, use the following command sequence: 


>UFD DMO: [252, 200] 
>PIP DMO: [252,200] /CD/FO/SU=DM1: [252,200] RED 


Refer to the RSX-11M Update Notes for a list of the directory 
specifications and backup set names for the layered product files. 


2.5 NON RSX-11M HOSTS 


You can perform an RSX-11M Update and system generation on host 
computers that are running under’ the control of operating systems 
other than RSX-11M. This section describes the privileges and 
conditions necessary to generate an RSX-11M system on an RSX-11M-PLUS 
host, and on a VAX/VMS computer that is running under VAX-11 RSX 

compatibility mode. 


2.5.1 Update and System Generation on an RSX-11M-PLUS Host 


To perform an RSX-11M Update and system generation on an RSX-11M-PLUS 
host, you must log in to a privileged account and set your command 
line interpreter to MCR. In addition, on an RSX-11M-PLUS Version 3.0 
host, you must set your directory to nonamed mode. 
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2.5.2 Update and System Generation on a VAX/VMS Host 


To perform RSX-11M Update and system generation on a VAX host computer 
running a VMS operating system of Version 4.0 or later, you must have 
the VAX-11 RSX compatibility mode installed. Then you must set the 
privileges and meet the requirements described in this section. 


2.5.2.1 Logging In and Setting Up Privileges - VAX/VMS uses the MCR 
indirect command file capability as the host system for RSX-11M Update 
and system generation. To use this capability, you must set’ the 
following privileges. Note that if you run the system generation from 
the system manager's account that is distributed with the VAX/VMS 
system (as long as its privileges have not been altered), you 
automatically have access to the required privileges. 


1. You must have change mode to kernel (CMKRNL) privilege. fThis 
allows you to perform a SET /UIC command that changes your 
default UIC. 


2. You must have logical I/O privilege (LOG IO). This allows 
VMR to perform logical I/O on system files. 


3. You must have volume protection privilege (VOLPRO). This 


allows you to mount volumes with the /FOREIGN keyword for the 
MOUNT command. 


4. You must have system protection privilege (SYSPRV). This 
allows you to create files in other directories. 


Use the following procedure to log in and set up the necessary 
privileges: 


1. Log in on the VAX/VMS system with the /CLI=MCR qualifier so 
that you can use MCR, the required command line interpreter 
(CLI) for RSX-11M Update and system generation. For example: 


Username: SYSTEM/CLI=MCR 
Password: (ED 


2. Set up the required privileges specified in steps 1 through 4 
of the previous list by issuing the following command line: 


>SET PROCESS/PRIVILEGES=(CMKRNL,LOG 10, VOLPRO,SYSPRV) 
3. Set your User Identification Code (UIC) to [200,200]: 
>Set /UIC=[200, 200] RED 


4. Set your default device to the baseline disk. For example, 
if your baseline disk is an RKO7 disk mounted in drive DMAO:, 
issue the following command: 


>Set default DMAO: 


2.5.2.2 Answering Questions Requiring Device Specifications - RSX-11M 
procedures running under the VAX-11/RSX environment expect answers to 
questions requiring device specifications to be in the form ddnn:, 
where "dd" is the device type and "nn" is the unit number (and ":" is 
a required terminator). However, on VMS systems, especially those on 
a VAX cluster, this type of device specification may not be acceptable 
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because of units of the same device type on more than one controller 
on the same processor (for example, DMAl: and DMB1:); or because of 
units of the same device type on more than one processor ona cluster 
(for example, MFAO: on node SIOUX and MFA0O: on node CUSTER). To 
resolve this ambiguity, you can use logical names in the form SS$nn: 
(your system manager can set up logical names in this form, according 
to the instructions in the VAX-11 RSX documentation) to represent the 
devices you will use. If the RSX-11M procedures need to know what 
type of physical device the logical represents, an additional question 
will be asked: 


Enter device type [dd] [S]: 


In such a case, answer this question with the RSX-11M two-character 
name of the physical device type (for example, DM or MF). 


NOTE 


The RSX-11M and VAX/VMS operating systems use 
different two-letter mnemonics for some types of 
devices. For example, the VAX/VMS mnemonic for a TU77 
magnetic tape drive is MT, while the RSX-11M mnemonic 
is MM. In such cases, you must enter the RSX-11M 
device-type mnemonic when you are prompted for the 
device type. 


CHAPTER 3 


STRUCTURE AND CONCEPTS OF SYSGEN 


The system generation procedure, called SYSGEN, is a series of related 
indirect command files. SYSGEN displays questions that require you to 
provide information concerning your target system hardware, Executive 
options, and general system features. SYSGEN uses that information to 
assemble and task build an RSX-11M operating system specifically 
tailored to your needs. 


This chapter discusses the general concepts and structure of SYSGEN. 
It separates SYSGEN into its logical parts and defines the purpose of 
each. This chapter also describes options that add flexibility and 
ease of use to the SYSGEN procedure. These options allow you to 
answer a minimum number of questions. 


3.1 THE LOGICAL PARTS OF SYSGEN 


There are three major parts to SYSGEN called phases. These three 
phases divide SYSGEN logically, based on the major activity in each 
phase. Each phase of SYSGEN requires that you answer a series of 
questions. Those answers supply data necessary for creating specific 
files during each phase of SYSGEN. SYSGEN then uses those files to 
produce an operating system that runs on your PDP-11 processor. 


3.1.1 Phase I 


Phase I is the assembly phase of SYSGEN. After you answer the 
questions in Phase I, SYSGEN uses your responses to assemble the 
Executive, a subset of MCR modules, the device drivers, and any 
industrial or laboratory I/O subsystems you may select. 


Phase I is the largest of the three phases of SYSGEN. It has more 
questions than the other SYSGEN phases. These questions are logically 
divided into seven sections. Each section focuses on specific 
functions of your RSX-11M system. 


SYSGEN pauses at the end of some sections to allow you the option to 
go back and correct any mistakes you may have made in a particular 
section without having to answer again all of the questions prior to 
that section. In this way, you can define your RSX-11M system section 
by section rather than all at once. (See Section 3.4.1.) 


Table 3-1 lists the seven sections in Phase I and their respective 
functions. 
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Table 3-1 
Phase I Sections and Functions 


Section Function 


Setup Section Defines. how Phase I executes and the 
method for input 


Target Configuration Defines the hardware characteristics 
Section of the target system 

Host Configuration Determines how to handle assembly and 
Section map listings 

Executive Options Defines the features you want included 
Section in your target system's RSX-11M Executive 
Terminal Driver Defines the type of terminal driver 
Options Section you want in your target system as well as 


the software features you want the 
terminal driver to support 


System Options Defines general system features, some 

Section privileged tasks, and specific system 
libraries to be included in your target 
system 

Peripheral Options Defines control information for 

Section peripheral devices included in your target 
system 


At the end of Phase I, SYSGEN has produced object and command files to 
be used as input to Phase II. 


Chapter 4 contains more information, including all of the questions, 
relating to SYSGEN Phase I. 


3.1.2 Phase II 


Phase II is the task-build phase of SYSGEN. After you respond to’ the 
questions in Phase II, SYSGEN uses your responses to task build the 
device drivers and privileged task images. 


NOTE 


SYSGEN always invokes the Version 4.2 Task Builder 
(TKB) distributed on your kit. The Task Builder is 
installed as task ...TKL. If you are doing an on-line 
SYSGEN, other system users can still use the system's 
TKB without any interference from SYSGEN.: 


Phase II is divided into nine sections, according to the particular 
processing activity. Some of the processing during Phase II does not 
require you to answer questions. Therefore, even though there are 
nine logical sections to Phase II, only five of those sections contain 
questions. 


Table 3-2 lists the nine sections in Phase II with their respective 
functions. 
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Table 3-2 
Phase II Sections and Functions 


Section Function 

Setup Section Defines how Phase II executes, the method 
for input, and the saved answer files that 
apply 

Library Build Creates object libraries and adds to 

Sectionl existing libraries 

Executive Task-Build Task builds the RSX-11M Executive 

Section 

System Image Creates the system image file 

Creation Section! RSX1L1M.SYS 

Full-Duplex Terminal Task builds the full-duplex terminal 

Driver Task-Build driver (optional) 


Sectionl 


Loadable Driver Task builds any loadable device 
Task-Build Section drivers 

Common Block Task- Task builds the optional FCS resident 
Build Section! library and industrial or laboratory 


device common blocks 


Privileged Task- Task builds privileged and system 
Build Section tasks 
System VMR Section Creates the VMR command file SYSVMR.CMD 


and runs VMR to augment the system image 


l. These sections do not contain questions. 


At the end of Phase II, SYSGEN has produced a bootable system image on 
which you can begin to run tasks. 


Chapter 5 contains more information, including all of the questions, 
relating to SYSGEN Phase II. 


3.1.3 VMR 


The System VMR Section is a vital step in SYSGEN Phase II. During 
this part of Phase II, SYSGEN creates a file called SYSVMR.CMD that 
augments the system image file using Virtual Monitor Console Routine 
(VMR) commands. VMR commands act on the file image on disk (whereas 
MCR commands act on the memory-resident system). See Chapter 10 in 
the RSX-11M/M-PLUS System Management Guide for VMR- command 
descriptions. 


STRUCTURE AND CONCEPTS OF SYSGEN 


After creating SYSVMR.CMD, SYSGEN asks if you wish to edit it. If you 
indicate that you wish to edit SYSVMR.CMD, SYSGEN pauses to allow you 
to do so. SYSVMR.CMD does the following: 


e Extends pool size 
e Creates memory partitions 


e Loads all loadable drivers 


e Installs the file system processor (FI11ACP) 
e Installs privileged and system tasks 


e Sets system parameters 


If you are generating your target system in a stand-alone environment, 
SYSGEN invokes SYSVMR.CMD during the System VMR Section. When Phase 
II ends, you are ready to bootstrap your new RSX-11M system. 


However, if you are generating your target system from an on-line host 
System, the System VMR Section completes without invoking SYSVMR.CMD. 
The reason for this is that you must use Version 4.2 of VMR and, in an 
on-line environment, SYSGEN cannot tell which version of VMR your 
on-line system is running. 


See Chapter 5 for more information on executing VMR from an _ on-line 
system. 


3.1.4 Phase III 


Phase III is a general task-building phase of SYSGEN. Generally, 
after the first two phases of SYSGEN have completed and you have saved 
and bootstrapped the new system, you are ready to invoke SYSGEN Phase 
Tit; (See the SAVE command in either the RSX-11M/M-PLUS System 
Management Guide or the RSX-11M/M-PLUS MCR Operations Manual.) 


In SYSGEN Phase III, you can task build any privileged or 


nonprivileged RSX-11M task. Phase III is also useful for rebuilding 
RSX-11M tasks that you have patched. 


Phase III allows you to rebuild some tasks to link to _ specific 
libraries (such as a resident FCS library), if your target system has 
such support. (Linking tasks to resident libraries can make the task 
images smaller, an obvious advantage when memory size is a 
limitation.) 


Chapter 7 contains more information, including all of the questions, 
relating to SYSGEN Phase III. 


3.2 SYSGEN INDIRECT COMMAND FILES 


As stated at the beginning of this chapter, SYSGEN is a_ series of 
related indirect command files. An indirect command file is a text 


file that contains commands interpreted by the Indirect Command 
Processor. 
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Three major indirect command files control SYSGEN execution: 
@ SYSGEN.CMD controls execution of Phase I 
e SYSGEN2.CMD controls execution of Phase II 
@ SYSGEN3.CMD controls execution of Phase III 


To invoke an indirect command file, issue the following command, where 
filename is the name of the command file you want to invoke: 


>@filename RED 


It is not necessary to include the file type .CMD when you invoke an 
indirect command file. 


Phases I, II, and III of SYSGEN reside in directory [200,200]. 
However, while it runs, SYSGEN resets the directory. If you exit 
SYSGEN and want to restart, be sure to set your directory to be 
[200,200]. 


3.2.1 Independent SYSGEN Command Files 


Some SYSGEN files can or must be invoked outside the normal SYSGEN 
procedure. For example, to rebuild a particular loadable device 
driver, you can invoke the file SGNBLDDRV.CMD without having to go 
through an entire SYSGEN. When you invoke any of these files, you 
must answer questions that supply the necessary input to the 
particular file. 


Those command files that can or must be invoked outside of SYSGEN are: 


e SGNBLDDRV.CMD can be invoked outside of SYSGEN to build device 
drivers 


@e SGNKLAB.CMD must be invoked outside of SYSGEN to build any 
K-series laboratory devices 


e BLDLAINIT.CMD can be invoked outside of SYSGEN to task build 
the LPA1L1-K device initialization task. The microcode that 
must be loaded into the LPA11-K is selected during this 
procedure. 


3.3 FORMAT OF SYSGEN QUESTIONS 


SYSGEN questions allow you to select the features you want for your 
target system. Based on your responses, SYSGEN generates various 
command files that control the assembly and task building of your 
RSX-11M system. 


The Indirect Command Processor determines the format of SYSGEN 
questions. 


The general format for SYSGEN questions is an asterisk followed by the 
uestion number, the text of the question, and a prompt (contained 
inside brackets) indicating the type of response required. Prompts in 
SYSGEN questions contain key letters that indicate how to respond to 
the question. See the RSX-11M/M-PLUS Indirect Command Processor 
Manual for a complete description of question formats in an Indirect 
command file. 
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SYSGEN questions require one of the following types of response: 


e An ASCII string response 


e A logical response--Y (for yes) or N (for no) 
e A numeric response 


Most SYSGEN questions have an implied response, known as the default. 
The default is the assumption made by SYSGEN if a particular option is 
not explicitly specified. Many of the SYSGEN questions contain’ the 
default response within brackets immediately following the text of the 
question. The default response appears in a given question to 


indicate the type of response required for that question (ASCII 
string, logical, or numeric). 


Press the RETURN key to select the default response for any SYSGEN 
question (unless there is no default for that question). 


The following is a typical SYSGEN question requiring an ASCII string 
response: 


* 8. Name of input saved answer file [D: SYSSAVED.CMD] [S]: 


The prompt [S] at the end of the above question indicates that the 
question should be answered with an ASCII string--in this case, a file 
name. The default appears in this question (indicated by the key 
letter D:) within the first set of brackets. Press the RETURN key to 


select the default file name of SYSSAVED.CMD for the input saved 
answer file. 


The following is a typical SYSGEN question requiring a Yes or No 
(logical) response: 


* 8. Do you want DIGITAL Command Language (DCL)? [Y/N]: 


The prompt [Y/N] at the end of the question indicates that’ the 
response should be either a Y (for Yes) or an N (for No). The implied 
default response for this type of question is No, unless explicitly 
stated otherwise. Some SYSGEN questions requiring a logical Yes or No 
response display an explicit default (indicated by the key D:). 


The following is a typical SYSGEN question requiring a numeric 
response: 


* 44, Swapping priority [D R:1.-20. D:5.]J: 


The prompt at the end of the question indicates that the question 
requires a numeric’ response. The first key letter D inside the 
bracket indicates that the response is a decimal number. The second 
key letter R indicates that the range for the response is from 1 
through 20. The third key letter D indicates that the default 
response is 5. 


Press the RETURN key to enter the default value of 5. 


The questions in the Peripheral Options Section of SYSGEN Phase I (see 
Section 4.8) are more complicated than the other SYSGEN questions. 
During this part of Phase I, SYSGEN provides additional information on 
how to answer the questions. The following is a typical question from 
the Peripheral Options Section: 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive, 
{[O=offset recovery support/No=no support] for: 


* 2. , DB controller 0 [D: 254,176700,,0,0]: 


3-6 
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The information on the line preceding the above question corresponds 
to the default field of the question. The first field, [L/R], allows 
you to choose whether the driver for the DB controller is loadable (L) 
or resident (R). (You determine whether the default for all drivers 
is loadable or resident earlier in Phase I.) 


The value 254 in the default field of the question is the vector 
address. The value 176700 is the default CSR address. The two 
successive commas following the CSR address imply that between them 
should be the number of drives. The description in the text for the 
question states that there is no default for this value; it must be 
explicitly entered. The zero following the two commas is the default 
unit number for the first drive. Finally, the letter 0 in the last 


position of the default field indicates that offset recovery is the 
default. 


Thus if you were to select all of the possible defaults for the DB 
controller, you would enter two commas (,,) followed by the explicit 
number of drives (the range is from 1 through 8). So your response to 
the question would look like the following: 


* 2. DB controller 0 [D: 254,176700,,0,0]: rr 


Everything after the number 4 in your response is implied and need not 
be entered when you are selecting the defaults. The two initial 
commas are necessary, however, to locate the value for the number of 
drives. : 


When answering the questions in the Peripheral Options Section, be 
sure to read the accompanying text carefully to avoid mistakes. 


When you answer a question with an incorrect value, SYSGEN displays a 
message describing the error, suggests a procedure to correct the 
problem, and repeats the question. 


Error messages appear alphabetically in Chapter 8. 


3.4 LOGICAL ORDER OF SYSGEN QUESTIONS 


Many of the options in SYSGEN are interdependent. Some options that 
you select automatically include other options. In such cases, SYSGEN 
prints a message on your terminal, informing you that these other 
options have been included. Furthermore, when you select an option 
that requires an option that you did not previously select, SYSGEN 
automatically includes the formerly-excluded option and informs you 
that it has been included. 


Other options are mutually exclusive. Therefore, even though SYSGEN 
questions are numbered in the order of their occurrence in the SYSGEN 
command files, not all SYSGEN questions appear on your terminal. 


For example, if you select DBMS-11l support in Question 1 of the 
Executive Option Section of Phase I, SYSGEN automatically includes 


support for Files-ll ACP (Question 2 of the Executive Options Section) 
and displays a message that Files-1l support has been included: 


* 1. Include support for DBMS-11? [Y/N]: yY 
Files-11 ACP support will be included. 
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If you do not select DBMS-11 support, SYSGEN asks Question 2: 


* 1. j%&Include support for DBMS-11? [Y/N]: N 


* 2. jFiles-11 ACP? [Y/N]: 


3.4.1 Breakpoints 


During execution of Phase I and Phase II, SYSGEN provides breakpoints. 
Breakpoints in SYSGEN are pauses at logical points during execution. 
There are two types of breakpoints: 


e End-of-Section (EOS) breakpoints 
e End-of-Execution (EOX) breakpoints 


These breakpoints cause SYSGEN to pause periodically during processing 
to let you review the process just completed (for example, the 
assembly of the Executive source files). SYSGEN allows you to 
override breakpoints so that it can execute unattended whenever 
appropriate. 


3.4.1.1 EOS Breakpoints - End-of-Section (EOS) breakpoints are pauses 
at the end of each section of the SYSGEN procedure. For instance, 
there are seven sections in Phase I. You can choose to answer the 
questions in all sections without EOS pauses or you can direct SYSGEN 
to pause at each EOS breakpoint. 


An End-of-Section breakpoint appears as a question from SYSGEN. For 
example: 


*EOS* Do you want to: <CR>-continue R-repeat section E-exit P-pause [S]: 
This breakpoint in the SYSGEN procedure allows you to: 

e Continue 

@ Repeat the section of questions, perhaps to correct answers 

e Exit the SYSGEN procedure 

e Suspend SYSGEN processing 


Note that if you type CTRL/Z in response to any question, SYSGEN exits 
cleanly (that is, all files are closed by the Indirect Command 
Processor). 


3.4.1.2 EOX Breakpoints - End-of-Execution (EOX) breakpoints are 
pauses after significant SYSGEN operations, such as a MACRO assembly 
or a task build. SYSGEN pauses at these points to ensure successful 
completion of the operation. When you know that the operation will 
execute successfully, you can direct SYSGEN to continue processing 
without the breakpoint pauses. 


The following EOX breakpoint question appears after assembly of the 
Executive: 


*EOX* Did the Executive assemble correctly? [Y/N]: 
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If your response is Y (for yes), SYSGEN continues to assemble a subset 
of MCR modules. If there are errors in the assembly, your response 
should be N (for No), at which point SYSGEN informs you that it is 
pausing to allow you to correct the problem. 


3.4.2 Chaining 


SYSGEN normally exits at the end of Phase I execution. However, an 
option in the Setup Question Section of Phase I allows SYSGEN to 
automatically invoke Phase II when Phase I completes. This process is 
called chaining. When SYSGEN chains to Phase II, it carries the 
information supplied in the Setup Section of Phase I to Phase II, 
thereby allowing SYSGEN to bypass many of the Setup Questions in Phase 
II. 


Chaining is a particularly useful option when you use an input saved 
answer file (see Section 3.5) or a Standard Function System (see 
Section 3.6.2). When you use a saved answer file and select the 
chaining option, you can generate a system without having to spend 
much time answering questions at the terminal. 


NOTE 


Chaining is a valid transition from Phase I to Phase 
II only. SYSGEN cannot chain from Phase II to Phase 
Iil. 


3.5 SAVED ANSWER FILES 


Whenever you answer a question during Phase I and Phase II, SYSGEN 
Saves your responses by converting them to symbol definitions and 
outputs them in saved answer files. (Appendix A lists the saved 
answer symbol definitions.) You can use a saved answer file as input 
to another SYSGEN. 


When you use saved answer files as input, SYSGEN uses the symbol 
definitions in the saved answer files as answers to SYSGEN questions. 
The questions do not appear on the terminal. If SYSGEN encounters a 
question for which there is no saved answer, it prints the question on 
the terminal and waits for a response. 


Depending upon how you answer the Setup Questions in SYSGEN Phase _ I 
and (optionally) in Phase II, you may create either a single file 
containing saved answers for both Phase I and Phase II or you may have 
one saved answer file for Phase I and a separate saved answer file for 
Phase II. In either case, SYSGEN always saves your responses in a 
file. 


NOTE 


SYSGEN does not save responses to questions in the 
Peripheral Options Section pertaining to ICR/ICS or 
DSS/DRS devices. SYSGEN also does not save responses 
to questions pertaining to the task building of the 
LPA initialization code. 
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SYSGEN asks you to specify a name for the saved answer file. You may 
give the saved answer file (or files) any name or file type that you 
wish. If you want to place your saved answer files in a different 
directory other than the default [200,200] and if that directory does 
not already exist, you must first create the directory using the MCR 
UFD command. For information on the UFD command, see the 
RSX-11M/M-PLUS MCR Operations Manual. 


Conventions governing file names for saved answer files are the same 
as for all RSX-11M file names. Refer to the RSX-11M/M-PLUS MCR 


Operations Manual or the RSX-11M Command Language Manual for more 
information on file names. 


SYSGEN asks the following question in the Phase. I and Phase II Setup 
Section to allow you to name your saved answer file: 


* 5. Name of output saved answer file [D: SYSSAVED.CMD] [S]: 


SYSGEN prints a message on the terminal letting you know the name of 
the output saved answer file to which it saves your responses. 


If the system generation process is aborted for any reason (for 
example, if you exit by typing CTRL/Z in response to any question), 
the output saved answer file is closed at the point in Phase I or 
Phase II where it was’ interrupted. If you use that output saved 
answer file for input later on, SYSGEN accesses the file, scans it, 
and prints a message that the file may be incomplete. The file may 
still be successfully used for input up to the point where the last 
question was answered in the aborted SYSGEN. (Before restarting 
SYSGEN, remember to reset your directory to [200,200].) At that point, 
SYSGEN begins explicitly asking questions again and creates a new 
saved answer output file. 


NOTE 


If the output saved answer file becomes locked when 
you abort a SYSGEN, you can unlock the file using the 
PIP /UN switch. See the RSX-11M/M-PLUS. Utilities 
Manual for details on using the PIP /UN switch. 


Saved answer files have a variety of uses. For instance, you can 
create a saved answer file that defines options for several different 
target configurations or you can create multiple saved answer files 
that specify different options for the same PDP-1l processor. See 
Section 3.6.1 for details on creating saved answer files. 


You can create saved answer files without having to fully execute 
SYSGEN by selecting the option in the Phase I Setup Section that 
inhibits execution of MCR commands in SYSGEN. Section 3.6 describes 
that option in detail. 


3.6 VARIOUS APPROACHES TO SYSGEN 


Some of the options available in the Setup Section of Phase I and 
Phase II can make it significantly easier to generate your system, 
particularly if you are generating an RSX-11M system for the first 
time. This section describes those options and how they can 
facilitate the SYSGEN process for you. 
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3.6.1 SYSGEN with MCR Inhibited (PREPGEN) 


During the Setup Section of Phase I, SYSGEN asks the _ following 
question: 


* 3. Do you want to inhibit execution of MCR commands (PREPGEN)? [Y/N]: 


This option allows you to perform the logical SYSGEN procedure, answer 
SYSGEN questions, and create a saved answer file that you can use as 
input to SYSGEN at a more convenient time when you actually generate 
your system. 


If you respond Yes to this option, SYSGEN displays the questions for 
you to answer and creates a saved answer file of your responses. 
However, SYSGEN does not process any MCR commands (such as PIP, MAC, 
and TKB) as it normally would and, therefore, does not create your 
system. 

If you respond No to this question, SYSGEN displays questions for you 


to answer, creates a saved answer file of your responses, executes MCR 
commands, and generates your target RSX-11M system. 


If you have never generated an RSX-11M system, or if you are 


unfamiliar with RSX-11M Version 4.2, you may find it helpful to 
perform a PREPGEN the first time you perform the SYSGEN procedure. 


3.6.2 The Standard Function System 

As previously explained, SYSGEN lets you create your own saved answer 
files. In addition, the distribution kit contains a saved answer 
file, called SGNSTAND.CMD. SYSGEN uses SGNSTAND.CMD to generate a 
Standard Function System when you select it as an option. 


When you select the option in Phase I for a Standard Function System, 
SYSGEN creates a mapped RSX-11M system that includes nearly all 
available options. The Standard Function System provides responses 
for SYSGEN questions pertaining to software. 
CAUTION 
Do not modify the contents of SGNSTAND.CMD. 
This means that SYSGEN automatically answers most of the Phase I and 


Phase II questions. 


The Standard Function System builds an’ RSX-11M system with maximum 
functionality including: 


e The full-duplex terminal driver (with all valid options) 
@e The MIDDLE version of FI1ACP 

@e Support for all layered products 

e The CO: and NL: pseudo devices 


e ANSI magnetic tape support 


e FCS resident library support 


STRUCTURE AND CONCEPTS OF SYSGEN 


e Support for all selected loadable drivers in DRVPAR 


e Default values for system (numeric) parameters (such as 
swapping priority) 


The only SYSGEN option restricted from the Standard Function System is 
support for user-written drivers. In addition, when you select the 
Standard Function System, SYSGEN bypasses EOS and EOX breakpoints and 
does not pause for you to edit any files. 


For the full list of options included in the Standard Function System, 
see Table 3-3. 


You can select some SYSGEN options when you choose the Standard 
Function System. SYSGEN displays those options at your terminal. 
Some user-selectable options are: 


e All Target Configuration Section questions 
e The Executive Debugging Tool (XDT) 
e The memory crash dump device 


e Communications products (such as DECnet) 
e A user-defined system name 


If you are unsure of which options to choose for your system, you’. can 
select the Standard Function System to quickly generate a usable 
RSX-11M system. As you become familiar with your system requirements, 
you can make more comfortable decisions about which system options are 
needed and which options may be unnecessary. You can then create a 
saved answer file geared more closely to your specific system 
requirements and then generate a new system using that saved answer 
file. 


The Standard Function System option works like other saved answer 


files since SYSGEN uses the symbols defined in that file as responses. 
SYSGEN does not display questions on your terminal that are answered 
by a saved answer file. 


Whenever you select the Standard Function System, you may find it 
helpful to also select the chaining option. ; 


Table 3-3 
Options Included in the Standard Function System 


Setup Section 


Question Option 
5 Mapped system 
Target Configuration Section 
Question Option Question Option 
4 K-series device support 15 CO: and NL: device support 


(Continued on next page) 
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Table 3-3 (Cont.) 
Options Included in the Standard Function System 


Executive Options Section 


Question 


1 


Option Question Option 
DBMS-11 support 35 Queue manager and queued print 
spooler 


13 


14 


15 


Files-11 ACP 
36 Group global event flags 


RMS-11 bucket locking 
and placement control 37 All system directives: 
Get Partition Parameters 


Nonresident tasks Get Task Parameters 
Send/Receive 
Loadable task loader Alter Priority 


Extend Task 


Executive common Connect to Interrupt Vector 
Get Sense Switch 


Memory management (PLAS) Set System Time 
directives Stop-bit 

Specify Requested Exit AST 
Send/Receive By Reference Parent/offspring tasking 
directives Parent/offspring tasking 


with chaining 


Get Mapping Context 


directive 38 5 pre-allocated QIO packets 
Address checking 

39 33-word size for the data 
1/O rundown transfer vector 
Multiuser protection 40 5-tick interval for 


round-robin scheduling 


ANSI magnetic tape ACP 


41 Highest priority class of 
On-line formatting (FMT) 150 for round-robin 
or diagnostic QIOs scheduling 
Loadable device drivers 42 Lowest priority class of 


1 for round-robin scheduling 


(Continued on next page) 
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Table -3-3 (Cont.) 


Options Included in the Standard Function System 


Executive Options Section 


Question Option Question Option 
16 All drivers loadable 
by default 43 Executive level disk 
swapping interval of 30 
17 Asynchronous system traps 
(AST) support 44 Priority of 5 for 
disk swapping 
19 Task termination and device 
not ready messages (TKTN) 46 30-second interval between 
printer not ready messages 
20 Power fail recovery 
47 30-second interval between 
21 Install, request, and card reader not ready 
remove on exit messages 
22 Large (20K) Executive 48 System crash register and 
stack dump device CSR 
23 Logical device assignment value of 177564 
24 Error logging support 49 Checkpointing 
28 Disk writecheck 50 Checkpointing with a system 
checkpoint file 
29 Software write-lock support 
51 Crash Dump Analyzer (CDA) 
31 Rotating pattern in data 
lights 52 CDA output notification 
device CSR value of 117564 
33 System-controlled partitions 
34 Shuffler support 
Terminal Driver Options Section 
Question Option Question Option 
1c Full-duplex terminal driver 13 Get terminal driver options 
Terminal Driver Options 
14 Hold-screen mode 
2 120-second unsolicited input 
timeout value 15 Transparent read/write 
3 Pass form feeds directly 16 Settable case conversion 
to the terminal for input 
4 Automatic carriage 17 Read after prompt 
return/line feed 
18 Read with no echo 


(Continued on next page) 


Question 


5 


ll 


12 


Question 


3 


4C 


Question 


3 
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Table 3-3 (Cont.) 
Options Included in the Standard Function System 


Terminal Driver Options Section 


Option 


Task checkpointable during 
terminal input 


Unsolicited input character 
AST 


Write with CTRL/O 
cancellation 


Break-through write 


CTRL/R support 


Escape sequence handling 


Get Multiple Characteristics 


Set Multiple Characteristics 


Systems Options Section 


Option 


FCS resident library 


Middle FCP (FCPMDL) 
Postmortem Dump (PMD) 


Resource Monitoring Display 
task (RMD) 


Question 


19 
20 


21 


22 


29 


24 


25 


26 


Question 


8 


10 


Option 


Read with special terminator 


CRT rubout support 


Terminal-host 
synchronization 


User terminal input 
buffering 


Variable-length terminal 
input buffering 


LA30P support 


Hardware unrecoverable input 
error notification 
Device-independent 
cursor positioning 


Option 

DIGITAL Command Language 
(DCL) 

Support for 2 user-written 


CLIs 


Pool monitoring and low 
pool recovery 


Loadable Driver Task-Build Section (Phase 2) 


Option 


NL: as the map device 
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3.6.3 The Autoconfigure Option 


Of all the questions to be answered in SYSGEN, the most complicated 
are those of the Peripheral Options Section in Phase I. It is not 
always convenient to obtain the correct CSR and vector addresses for 
your specific peripheral devices. Though SYSGEN provides default CSR 
and vector addresses for most devices, there is no guarantee that your 
devices correspond to those addresses. 


To avoid confusion, direct SYSGEN to Autoconfigure your hardware. The 


Autoconfigure option is the first option offered in the Setup Section 
of Phase I and is integrated with the SYSGEN procedure. 


Autoconfigure is a valid option only if you are generating RSX-11M 
from the baseline system (located in directory [1,54]) supplied with 
your RSX-11M Version 4.2 distribution kit. Typically, on-line systems 
(that is, systems running from other than the baseline system) have 


some disk, terminal, and CPU activity. Part of autoconfiguration 
involves a complex series of device interrupts that require there be 
no other activity on the system. Autoconfigure can accurately 


configure the hardware only when there is no pending I/0. In 
addition, to use the Autoconfigure results, the host system must be 
the same as the target system. 


Autoconfigure determines the correct hardware configuration. This is 
a highly desirable option in all but two cases: 


@ Autoconfigure cannot be used when the host system is 
distinctly different from the target system configuration. 


@e Autoconfigure cannot be used when the hardware does not 
conform to the standard PDP-11 device configuration algorithm. 
If your hardware does not conform to this standard, please see 
Appendix E for information on determining the algorithm for 
your hardware. 


Autoconfigure allows you to add or delete devices as well as override 
results. See Section 3.6.3.2. 


3.6.3.1 What Autoconfigure Does - When you select the Autoconfigure 
option, SYSGEN automatically determines the correct hardware 
configuration of most (if not all) of your host system: the processor 
type, the CSR and vector addresses of your peripheral devices, and any 
optional hardware that may be present--such as Floating Point or 
Extended Instruction Set hardware. SYSGEN displays complete 
information from the autoconfiguration at your terminal after the 
Autoconfigure has completed. 


You may use the Autoconfigure results for responses to questions in 
the Target Configuration and Peripheral Options Section in Phase I. 
In this case, SYSGEN automatically answers (and therefore bypasses) 
any questions in those sections for which Autoconfigure results can be 
used as responses. You can also override the results of Autoconfigure 
(see Section 3.6.3.2). 


In addition to those devices that are automatically configured, you 
may add devices that Autoconfigure does not support. You can do this 
by answering Question 15 in the Target Configuration Section (entering 
the device names and the number of controllers). (See the Target 
Configuration Section, Question 15, in Section 4.3 for more 
information on adding devices.) 
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Furthermore, if you use an input saved answer file containing a_ saved 
peripheral configuration and also Autoconfigure the host system 
hardware, SYSGEN makes a contiguous list of all of those devices. 
Where there are discrepancies between the devices in the saved answer 
file and the Autoconfigured list, the saved answer file always 
overrides the Autoconfigured list. 


If SYSGEN fails to report Autoconfigure results (described in Example 
3-1) within one minute, then Autoconfigure has failed to configure 
your hardware. If this occurs, you must rebootstrap the baseline 
system and invoke SYSGEN again without using the Autoconfigure option. 
When SYSGEN fails to report Autoconfigure results, it is generally an 
indication that a severe hardware malfunction has occurred or you have 
not adhered to the standard DIGITAL PDP-ll device configuration 
algorithm detailed in Appendix E. 
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Example 3-1: Sample Autoconfigure Output 


Processor Type: 11/70 Memory Size: 512. Kw) 
Options: 


Floating Point Processor (FP11) 
Extended Instruction Set (EIS) 
.Extended (22-bit) Addressing 
Switch Register (SWR) 

Display Register 

Cache Memory 

Parity Memory 


Name Vector CSR Unit Type Remarks 
DKA 220 177404 
0 RKO5 
2 RKO5 
DMA 210 177440 
0 RKO06 
1 RKO6 
2 RKO7 
RHA 224 172440 
0 0 TU77 TMO3 
01 TU77 TM03 
RHB 150 176300 = 
0 RMO3 
RHC 204 176400 
0 ML11A 
RHD 254 176700 
0 RPO6 
1 RPO6 
2 RPOS5 
3 RPOS5 Dual access 
DXA 264 177170 
DTA 214 177342 
LPA 200 177514 
LPB 270 164004 
YLA 060 177560 
YLB 2?? 175610 Failed to interrupt 
YMA 310 170500 
YMB 314 170510 
YMC 324 170520 
YHA 340 160020 
YHB 350 160040 
YHC 360 160060 
YHD 22? 160100 Failed to interrupt 


Example 3-2 lists all the remarks that may be output by Autoconfigure 
with the configuration information. 
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Example 3-2: Autoconfigure Remarks and Meanings 


Remark Meaning 

Failed to interrupt Either the specified device is 
malfunctioning or the hardware 
configuration is nonstandard, which causes 
Autoconfigure to report unreliable 
information. Autoconfigure will place 
three question marks (???) in the vector 
field. 

Mixed MASSBUS devices Autoconfigure has detected a MASSBUS 


controller configured with several classes 
of peripherals attached to the same 
controller, (such as RMO3 and an RPO6). 
Note: Mixed MASSBUS configurations are 
not supported by RSX-11M. 


TMO2 The type of magtape formatter 
TM03 associated with this slave drive. 
TM78 Magtape unit numbers are displayed in the 
format: Formatter Unit number, 
underscore, Slave Unit number (for 


example, 0 1). 


Priority n . Autoconfigure has detected a device with 
an interrupt priority higher than 
expected. n is the actual interrupt 
priority. 


Dual access The specified unit has the dual-access 
option installed. Dual access allows a 
unit to be shared by two controllers. 
Note: Use of drives in dual-access mode 
is not supported on RSX-11M. 


2??? =(in the vector field) See Failed to interrupt. 


Sector interleaved The RSO3 or RSO4 displayed supports sector 
interleaving, which allows the unit to 
optimize data accesses. 


3.6.3.2 Overriding Autoconfigure Results - When you select the 
Autoconfigure option, SYSGEN asks a second question that allows you to 
override the results of Autoconfigure. This option directs SYSGEN_ to 
display the Autoconfigure results in the default field of each 
question where Autoconfigure would automatically provide a response. 
In other words, instead of directing SYSGEN to use Autoconfigure 
results as responses to the questions in the Target Configuration and 
Peripheral Options Sections without displaying them on the terminal, 
each SYSGEN question appears with the Autoconfigure results as_ the 
default instead of the standard default response. You may then 
examine the Autoconfigure results and either enter different values or 
press the RETURN key to input the Autoconfigure result. 
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If you choose not to override the results of Autoconfigure, SYSGEN 
automatically answers any question in the Target Configuration and 
Peripheral Option Sections when Autoconfigure has provided responses. 
The only exception to this is Question 15 in the Target Configuration 
Section. This question always appears to allow you to add or delete 
devices from your configuration. 


You can override Autoconfigure results to enter information not 
normally determined by Autoconfigure. For example, if your system has 
four RKO6 drives, but one is down with serious hardware problems, 
Autoconfigure would only report finding three of them. However, if 
you know that the drive will be repaired soon, you can override the 
Autoconfigure results by entering 4 as the number of unit types for 
the RKO6 instead of using the default of 3 provided by Autoconfigure. 


Furthermore, you can override Autoconfigure results so that you’ can 
generate a transportable system. For example, if your site has two 
PDP-11/34 processors, but only one of them (that is, the host system) 
has cache memory, you can override the results of Autoconfigure by 
deselecting the cache memory option to have an RSX-11M system that 
runs on either processor. 


Table 3-4 lists the devices supported by the Autoconfigure option. 
Devices that are not listed in Table 3-4, as well as any 
malfunctioning devices, cannot be Autoconfigured. 


NOTE 


Your host system configuration must conform to the 
standard PDP-1ll device configuration algorithm for 
Autoconfigure to report reliable information. (See 
Appendix E.) 


3.6.4 Hardware Supported by Autoconfigure 


Autoconfigure supports most standard devices supplied by DIGITAL. For 
those DIGITAL devices in your hardware configuration not supported by 
Autoconfigure, SYSGEN asks the appropriate question in the Peripheral 
Options Section to get the specific controller information for those 
devices. 


Autoconfigure does not determine the number of units for DK, DP, DT, 
or MT devices, but it does determine the CSR and vector addresses for 
those devices. SYSGEN asks the corresponding questions in the 
Peripheral Options Section that require you to input the number of 
units for those devices. 


In addition, Autoconfigure finds only those RKO5 drives that have 
disks in them and are up and spinning at the time of the 
Autoconfigure. 


Table 3-4 is a list of the hardware supported by Autoconfigure. Refer 


to Appendix E for the algorithm used to assign addresses to devices 
attached to the UNIBUS or Q-BUS. 


NOTE 


Autoconfigure will run only on processors with memory 
management (mapped) hardware. Also, Autoconfigure 
computes the line frequency of your processor only if 
a KW11-P programmable clock is present. 


PDP-11/23 


PDP-11/23-PLUS 


MicroPDP-11 


PDP-11/24 
PDP~11/34 
PDP-11/35 
PDP-11/40 
PDP-11/44 
PDP-11/45 
PDP-11/50 
PDP-11/55 
PDP-11/60 
PDP-11/70 


LSI-11/73 


MicroPDP-11/73 


MicroPDP-11/83 
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Table 3-4 


Hardware Supported by Autoconfigure 


Processors (with memory management hardware) 


22-Bit Addressing 


(Autoconfigure reports the MicroPDP-11 as 
an 11/23-PLUS) 


18- and 22-Bit Systems 


(Autoconfigure reports the 11/35 as an 11/40) 


(Autoconfigure reports the 11/50 as an 11/45) 


(Autoconfigure reports the 11/55 as an 11/45) 


PDP-11/84 

Processor/Memory Options 
FP-11 FPP--Floating Point Processor 
KE-L1E EIS--Extended Instruction Set 
KE-11A/B EAE--Extended Arithmetic Element 


CiS--Commercial Instruction Set 


FIS--Floating Instruction Set 


(Continued on next page) 
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Table 3-4 (Cont.) 
Hardware Supported by Autoconfigure 
KW11-P Programmable Clock 
Cache Memory 
Switch Register 
Display Register 
Parity Memory 


KW11-W Watchdog Timer 


I/O Peripherals and Controllers 


CT: TA1L1 Tape Cassette 

DB RP04/05/06 Disk Drive 

DD © TU58 Cartridge DECtape 

DK RK11/RKO5 

DL RL11/RLV11/RLO1 Disks (first controller only) 
RL211/RLV21/RLV12/RL02 Disks (first controller 
only) 

DM RK611/RK711 RKO6/RKO7 Disks 

DP RP11/RP02/RP03 

DR RM02/RM03/RMO5/RM80/RPO7 Disk Drives 

DS RSO03/RS04 Fixed-Head Disks 

DT TC11/TU56 DECtape 

DU UDA50 (RA60/RA80/RA81) Controller 


RC25 Controller 
RQDX1 (RD51/RX50) Controller 
RQDX1 (RD52/RX180) Controller 


DX RX11/RX01 Diskette (first controller only) 
DY RX211/RX02 Diskette (first controller only) 
EM ML11 Nonrotating Electronic Memory 

LP LP/LS/LV/11/LNO1 Line Printer 


(Continued on next page) 


MM 


MS 


MT 


MU 


PR 


PP 


RH 


XE 


YH 


YL 


YL 


YL 


YL 


YM 


YV 


YZ 
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Table 3-4 (Cont.) 


Hardware Supported by Autoconfigure 


TU16/45/77/TE16 Magnetic Tape Drives 
TS11/TSVO5/TU80 Magnetic Tape Drives 
TM11/TU10/TE10/TS03 

TK50 Streaming Cartridge Tape 
PR11/PC1ll Paper Tape Reader 

PCll Paper Tape Punch 

RH11/RH70 MASSBUS Controller 

DEUNA UNIBUS Ethernet Controller 
DH11 Asynchronous Terminal Interface 


DL11-A/B Asynchronous Terminal Interface 
(including DLV) 


DL11-C/D/E Asynchronous Terminal Interface 
(including DLV) 


DL11-J Asynchronous Terminal Interface 
(including DLV) a 


DL11-W Console Interface with line clock 
DM11-BB Modem Controller for DH11l 
DHU11/DHZ11 Asynchronous Terminal Interface 


DZ11 Asynchronous Terminal Interface 
(including DZQ and DZV) 


CHAPTER 4 


DETAILS OF SYSGEN PHASE I 


This chapter describes the questions in SYSGEN Phase I. SYSGEN uses 
your responses to the questions in Phase I to assemble the source 
files for the Executive, device drivers, and any laboratory or 
industrial I/O subsystems you select. As explained earlier in Chapter 
3, SYSGEN never asks all of the questions described in this chapter. 
Therefore, the questions do not always appear on your terminal in 
numerical sequence. As long as you know the Phase I section that the 
question appears in, you can locate the description of that question 


by its number. 
The questions are divided logically into seven sections: 

e Setup Section 

e Target Configuration Section 

e Host Configuration Section 

e Executive Options Section 

e Terminal Driver Options Section 

e System Options Section 

@e Peripheral Options Section 
Example 4-1 (at the end of this chapter) is an annotated terminal 
Output from SYSGEN Phase I. The responses in the example are not 
necessarily the same as yours may be. However, the example will help 


you to follow the flow of questions from section to section. 


Figure 4-1 shows the processing steps that take place during SYSGEN 
Phase I. 


INPUT ACTION OUTCOME 


SAVED ANSWERS 


EXPLICIT RESPONSES 
AUTOCONFIGURE RESULTS ASSEMBLE THE EXECUTIVE, EXECUTIVE, DRIVER, 


DRIVERS, AND A SUBSET AND MCR SUBSET PHASE II 


EXECUTIVE, DRIVER, AND MCR a eaHEOsFIEES 


SUBSET SOURCE FILES 


Z2K-322-81 


Figure 4-1 Processing Steps in SYSGEN Phase I 
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4.1 PREPARING FOR PHASE I 


Before invoking SYSGEN, make sure you have done the following: 


If you are using a Version 4.1 host system, refer 


generation. 


If you generate your system from an on-line Version 


system, 


NOTE 


To perform a SYSGEN, your host system must be 
mapped. If your host system is not mapped, 
SYSGEN will display the following message: 


SYSGEN is not supported on 
an unmapped host system. 


Also, your host system must have at least 64K 
words of memory. If your system has fewer 
than 64K words of memory, SYSGEN will display 
the following message: 


SYSGEN is not supported on a 
host system with less than 64KW. 


set your directory to be [200,200], assign the 


4. 


to the 


RSX-11M/RSX-11S Release Notes before beginning your system 


2 host 
logical 


device SY: to your baseline disk, and invoke SYSGEN as 


follows: 


>SET /UIC=[200,200] 

>ASN ddu:=SY: QReD (where ddu: is the baseline 
>MOU ddu:RSXM38 QED 

> @SYSGEN (ED) 


The host system must have a null device (NL:) for 
generate an RSX-11M system successfully. 


If you generate your system from a stand-alone host 
hardware bootstrap the baseline system. (See Appendix 


Then invoke SYSGEN as follows: 


> @SYSGEN 


Phase I begins now. 


disk, RSXM38) 


you to 
system, 
B.) 
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SETUP 


4.2 SETUP SECTION 


This section of questions provides SYSGEN with specific processing 
information. In addition, depending on your responses, it can help to 
make your system generation significantly easier. 


* 1. Autoconfigure the host system hardware? [Y/N]: 


If you respond Yes to this question, SYSGEN automatically determines 
the exact hardware configuration of your host system: the processor 
type, the CSR and vector addresses of your peripheral devices, and any 
optional hardware that may be present--such as Floating Point or 
Extended Instruction Set hardware. (See Section 3.6.3 for more 
information on Autoconfigure.) 


SYSGEN displays results from the autoconfiguration at your terminal 
after Autoconfigure has completed. Table 3-3 lists the devices 
supported by Autoconfigure. Devices that are not listed in Table 3-3, 
as well as any malfunctioning devices, cannot be autoconfigured. 


NOTE 


Your host system configuration must conform to the 
standard PDP-ll device configuration algorithm for 
Autoconfigure to report reliable information. (See 
Appendix E.) 


If you choose this option, you may use the _ results of the 
autoconfiguration for responses to questions in the Target 
Configuration and Peripheral Options Sections. If you respond Yes’ to 
this question, and No to Question 2, SYSGEN bypasses any questions in 
the Peripheral Options and Target Configuration Sections for which 
Autoconfigure results can be used as responses. 


This question only appears if you are generating an RSX-11M_ system 
from a mapped RSX-11M baseline system. 


* 2. Do you want to override Autoconfigure results? [Y/N]: 


This question appears only when you respond Yes to Question l. 


If you respond Yes to this question, you can override the 


Autoconfigure results. SYSGEN displays the results of the 
autoconfiguration in the default field of each Peripheral Options and 
Target Configuration question asked. You may then examine the 


Autoconfigure results and either modify them or press the RETURN key 
to take the default. (See Section 3.6.3 for more information.) 


If you respond No to this question, Autoconfigure automatically 
answers the questions in the Target Configuration Section except for 
the K-series question (Question 4) and Question 9 or 10 of that 
section. 
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In addition to answering the Target Configuration Section questions, 
Autoconfigure automatically answers all the questions in the 
Peripheral Options Section for which Autoconfigure has results. 


NOTE 


Autoconfigure determines only the CSR and vector 
addresses for DK, DP, DT, MT, and MU device types. It 
cannot determine the number of units’ for those 
devices. SYSGEN asks the corresponding questions in 
the Peripheral Options Section to allow you to. enter 
the number of units for those devices. 


In addition to those devices that are configured automatically you may 
add devices that Autoconfigure does not support or are not present on 
the host system. You do this by answering Question 15 in the Target 
Configuration Section (this question is always asked) with the device 
names and number of controllers for those additional devices not 
listed by Autoconfigure. (See Question 15 for more information on 
adding devices. Also see Section 3.6.3.) 


‘i Vi 
* 3. Do you want to inhibit execution of MCR commands (PREPGEN)? [Y/N]: 


If you respond Yes to this option, SYSGEN displays the questions for 
you to answer and creates a saved answer file of your responses. 
However, SYSGEN does not process any MCR commands as it normally would 
and, therefore, does not create your system. When you are ready to 
generate your system, you can then use this saved answer file as input 
into SYSGEN. 


It is recommended that you perform a PREPGEN first. Doing so has’ two 
advantages: first, it requires less time at your terminal to answer 
SYSGEN questions: second, if you are not satisfied with your system 
configuration, you can easily change your responses in the saved 
answer file rather than do another SYSGEN to change your’ system 
configuration. 
When you perform a PREPGEN, SYSGEN: 

e Creates the resident driver data base file (SYSTB.MAC) 

e Creates a partial, unusable Executive prefix file (RSXMC.MAC) 

e Creates a saved answer file 


e Creates the Executive task-build file 


e Creates the full-duplex terminal driver task-build file (if 
you select the full-duplex terminal driver) 


@e Creates the Executive and driver assembly command files 


DETAILS OF SYSGEN PHASE I 


SETUP (Cont.) 


However, when you perform a PREPGEN, SYSGEN does not: 
@ Make logical device assignments 
@e Delete files from previous SYSGENs 
e Assemble files 
e Create libraries 


If you are using an RLO1/RLO2 distribution kit and you select this 
option, the number of drives required for doing a system generation 
depends on whether you will be chaining from Phase I to Phase II 
(Question 15 in this section) and if the system generation will be 
unattended. The following list explains what happens in the various 
situations: 


e If you are chaining from Phase I to Phase II, two drives are 
required for the PREPGEN--one for the RSXM38 disk and one for 
the EXCPRV disk. 


e If you are chaining from Phase I to Phase II and the system 
generation will be unattended, three drives are required--one 
each for the RSXM38, EXCPRV, and PRVBLD disks. 


e If you want to chain from Phase I to Phase II but only two 
drives are available, you will be instructed at the beginning 
of Phase II to remove the EXCPRV disk from its drive and 
replace it with the PRVBLD disk. 


e If you are not chaining from Phase I to Phase II and Phase I 
will be unattended, or if Phase II will be unattended, two 
drives are required. At the beginning of each Setup Section, 
you will be requested to mount the appropriate disk (EXCPRV 
for Phase I and PRVBLD for Phase II). 


If you respond No to this question, SYSGEN executes MCR commands’ and 
creates your system. 


* 3A. Do you want to create the assembly and build files on the SY: 
device? [Y/N D:Y] 


This question appears only if you answered Yes to Question 3 (Inhibit 
MCR commands) and if you are using the RLO1/RLO2 distribution kit. 


Your answer determines where SYSGEN will create the assembly and 
task-build files. If you answer Yes or take the default, the files 
are created on SY:. If you answer No, the files are created on NL:. 


Creating the files on one of these pseudo devices helps recover space 
on the RSXM38 and EXCPRV disks. ; 


* 4. Have you made a copy of the distribution kit? [Y/N]: 


A copy of the distribution kit ensures that there is a backup copy in 
case you inadvertently delete important files or data during the 
system generation process. A backup copy also serves as a base _ for 
future Updates. 
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If you respond No, SYSGEN displays the message: 


SGN -- You are or will be running on the original copy of 
the distribution kit. Make a copy via the standard 
procedure and restart. 


SYSGEN then exits to allow you to copy the media. 
Refer to Chapter 2 if you need help copying your distribution kit. 


This question does not appear if you are generating an RSX-11S system 
from a host system other than RSX-11M. This question also does not 
appear if your response to Question 3 is Yes. 


* 5. Are you generating an unmapped system? [Y/N]: 


Respond Yes to this question if your target system processor does not 
include a Memory Management Unit (such as a KT-11) and if you intend 
to generate an unmapped system. 


If you generate an unmapped target system from the mapped baseline 
system or from a mapped host system, you must invoke Phase III on the 
host system to task build unmapped versions of EDI, PIP, and TKB (that 
is, before invoking Phase III on the target system). 


* 6. Use an input saved answer file? [Y/N]: 


Respond Yes to this question if you have previously created a_e saved 
answer file. This option lets you direct SYSGEN to use that file as 
input responses to the questions. Any SYSGEN question automatically 
answered by a saved answer file does not appear on your terminal. 


SYSGEN does not save responses to the Peripheral Options Section 
questions for the ICR/ICS or DSS/DSR devices. You must enter the 
responses for those devices. 


* 7. Name of input saved answer file [D: <default> ]: 


SYSGEN displays this question only if you respond Yes to Question 6. 
If the file SYSSAVED.CMD exists in the current UFD, the default file 
name for the input saved answer file is SYSSAVED.CMD. Press the 
RETURN key to input the default filename of SYSSAVED.CMD. 


If you have created a saved answer file having a different file name, 
you may enter the name of that file. The input saved answer file name 
must conform to the RSX-11M file-name standard. 

If the specified file does not exist, SYSGEN repeats Question 7. 


If you enter a response other than the default and omit a file type, 
SYSGEN assumes the file type .CMD. 
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If you are using an incomplete saved answer file for input, SYSGEN 
issues a message indicating that the file may be incomplete. In that 
case, when SYSGEN encounters a question for which your saved answer 
file does not have a response, SYSGEN displays that question on your 
terminal and waits for you to input a response. 


* 8. Do you want a Standard Function System? [Y/N]: 


This option allows you to direct SYSGEN to generate a mapped RSX-11M 
system having most of the available software options automatically 
included. Your target system should have at least 64K words of memory 
if you intend to select this option. 


If you respond Yes to this question, SYSGEN displays only those 
questions not defined in the Standard Function System. 


If you respond No to this question, SYSGEN requires that you answer 
each question individually. 


See Section 3.6.2 for more information on the Standard Function 
System. This question appears only if you are generating a mapped 
RSX-11M system and did not choose to use an input saved answer file. 


* 9, Name of output saved answer file [D: <default>]: 


This option lets you assign a file name to the output saved answer 
file (that is, the one created during the current SYSGEN). 


The default name of the output saved answer file is the same as that 
of the name of the input saved answer file. 


If you want to place your saved answer file in a directory other than 
the default directory ([200,200]), you must create that directory 
using the MCR UFD command before beginning your SYSGEN if it does not 
already exist on the RSXM38 disk. For more information on the MCR UFD 
command, see the RSX-11M/M-PLUS MCR Operations Manual. 


If the directory does exist, type in the directory and the file name 
in response to the question. 


Otherwise, if you answered No to Question 7 or if you selected the 
option for a Standard Function System, the default name of the output 
saved answer file is SYSSAVED.CMD. 


If you enter a response other than the default and if you omit the 
file type, SYSGEN assumes the file type .CMD. 


Press the RETURN key to select the default response. 
* 10. Use saved host configuration? [Y/N]: 


This option allows you to use previously defined (Saved) answers’ to 
Host Configuration Section questions. When you are running SYSGEN on 
line and have all the listings you need, you may want to change _ the 
Host Configuration Section answers in your saved answer file to 
redefine the way SYSGEN handles listings. 


4-7 
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If you respond Yes, your answer implies that you are performing a 
SYSGEN on the same, or similar, configuration you used to create the 
saved answer file. 


This question appears only if you responded Yes to Question 6 (Use 
saved answers). 


* 11. Use saved peripheral configuration? [Y/N]: 


This option allows you to modify the previously defined (saved) 
peripheral configuration contained in the saved answer file. If you 
respond Yes to this question, SYSGEN uses the saved peripheral 
configuration. 


If you respond No, SYSGEN asks Question 15 of the Target Configuration 
Section. 


Note that if you answer No, it does not affect the input saved answer 
file and does not permit you to change vectors or CSRs of previously 
defined devices. Answering No permits you to change only the number 
of controllers. Respond No to add or delete controllers. 

This question appears only if you responded Yes to Question 6 (Use 
saved answers). 


* 12. Skip End-of-Section (EOS) breakpoints? [Y/N]: 


This option allows you to choose whether or not to stop at 
End-of-Section (EOS) breakpoints. At these breakpoints, you can 
select whether to continue SYSGEN questions, repeat questions in the 
preceding sections (to correct answers), exit from SYSGEN, or cause 
SYSGEN to pause. 
Breakpoints occur at the following points in SYSGEN Phase I: 

e After the Target and Host Configuration Sections 

e After the Executive Options Section 

® After the Terminal Drivers Options Section 

e After the Peripherals Options Section 

e After the System Options Section 
If the answers in the saved answer file correctly define the system 
you want to generate, you can direct SYSGEN to complete execution 


without interruption by answering Yes to this question. 


This question appears only if you responded Yes to Question 6 (Use 
saved answers). 
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* 13. Skip End-of-Execution (EOX) breakpoints? [Y/N]: 


End-of-Execution (EOX) breakpoints occur after the MACRO-11 assembler 
completes execution. If you know that the MACRO-11 processing will 
complete successfully, respond Yes to direct SYSGEN to proceed without 
pausing. 


If you respond No, SYSGEN pauses after execution of these tasks to 
allow you to check the results and make any necessary corrections. 


This question appears only if you responded No to Question 3 (Inhibit 
MCR command lines) and Yes to Question 6 (Use saved answers). 


* 14. Clean up files from previous GENs? [Y/N]: 


When you are generating multiple systems on the same media, SYSGEN 
creates files that may not be appropriate from one system to the next. 
This question allows you to direct SYSGEN to delete all such 
unnecessary files. 


This question appears only if you respond No to Question 3 (Inhibit 
MCR commands). 


* 15. Chain to Phase II after Phase I completes? [Y/N]: 


If you respond Yes to this question, SYSGEN automatically invokes 
Phase II at the completion of Phase I. This question does not appear 
if you are generating an RSX-11S system or if SYSGEN2.CMD is not in 
directory [200,200] on the SY: disk. 


Chaining is most useful when you are using a complete saved answer 
file for input to both Phase I and Phase II. In this case, you can 
complete most of a SYSGEN unattended. 


* 16. Enter device for EXCPRV disk when it is ready (dduu:) [D: DL1:][S]: 


Enter the device type and unit number (dduu:) for the drive containing 
the files needed to assemble the Executive, drivers, and some MCR 
modules during Phase I (EXCPRV). This disk will be dismounted at the 
end of Phase I. 


SYSGEN appends the trailing colon if you omit it in your response. 


This question appears only if you are using the RLO1/RLO2 distribution 
kit. 
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* 17. Enter device for PRVBLD disk when it is ready (dduu:) [D: DL2:][(S]: 


Enter the device type and unit number (dduu:) for the drive containing 
the files needed to build the Executive, drivers, libraries, and 
privileged tasks during Phase II (PRVBLD). SYSGEN mounts the device 
if it is not the same as the one used for the EXCPRV disk. 


SYSGEN appends the trailing colon if you omit it in your response. 


This question appears only if you are using the RLO1/RLO2 distribution 
kit and if you are chaining from Phase I to Phase II. 
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4.3 TARGET CONFIGURATION SECTION 


This section of questions defines the target processor type and _ the 
options and peripheral devices included in the target system. If you 
are running SYSGEN on a Version 4.2 system and if you choose the 
Autoconfigure option (Question 1 in the Setup Section), questions in 
this section requiring a logical (Yes or No) response may display an 
explicit default response. The explicit default response (indicated 
by the key D:) may be Yes or No. 


* 1. Processor Type [D: 11/34]: 


Enter the target PDP-1l processor type. 


Valid entries are: 


LSI-11* 11/20* 11/44 11/73 
LSI-11/73 

11/03* 11/23. 11/45 3911/83 
11/04* 11/24 11/50 11/84 
11/05* 11/34 11/55 KxJl1l 
11/10* 11/35 11/60 

11/15* 11/40 11/70 


Those processors that are marked with an asterisk (*) do not support 
memory management hardware. Therefore, they support unmapped systems 
only. 


If you specified earlier that you are generating a mapped system, your 

response to this question must be one of those processors listed that 

is not marked with an asterisk. Otherwise, SYSGEN ignores’ your 
response and repeats the question. 


NOTE 


If your processor is either a PDP-11/23-PLUS or a 
MicroPDP-1l, enter 11/23 as your processor. Then in 
Question 3, enter 128(10) or more as the memory size. 
Doing so tells SYSGEN that your processor is a 
PDP-11/23-PLUS. 


SYSGEN always asks this question. 
* 2. Does processor have a switch register? [Y/N D:N]: 


The switch register is a reserved memory address to which you. can 
write data. Under program control, you can read the contents of the 
Switch register via the GSSWS (Get Sense Switch) Executive directive. 
Not all processors have a switch register. If the processor for your 
target system does not have a switch register, you cannot use the 
GSSWS directive. 
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Processors that do have switch registers vary in the way that you can 
access them: 


@ There may be toggles on the front panel that you use to key in 
data to the switch register. 


@ Some newer processors have a keypad on the front panel instead 
of toggles. , 


e On other processors, the console terminal replaces the toggles 
or keypad as the means of accessing the switch register. 


This question appears only if the PDP-1l processor you specified (in 
Target Question 1) is an 11/03, 11/04, 11/23, or 11/34. Other 
processors always include a switch register. 


* 3. Memory size (in K-word blocks) [D R:16.-124. D:64.] 


Enter the amount of memory for your target system processor in 
1024-word blocks (1K). Memory sizes apply to addressable memory only 
(not including the I/O page). The legal range is from 16K through 
1920K, but that range depends on the minimum and maximum memory sizes 
for your particular processor. SYSGEN calculates the range values 
(min and max) based on your response to Question 1 in this section. 


NOTE 


Various system components (especially the Executive) 
use the memory. Size to determine whether your 
processor has 16-, 18-, or 22-bit addressing mode. 


If you selected the Standard Function System (Setup Question 8), you 


must specify a minimum of 64K words of memory. Otherwise, SYSGEN 
issues an error message and exits. 


Table 4-1 shows the minimum and maximum memory sizes for 
RSX-11M-supported PDP-1l1l processors. 


Memory size must be specified in 4K increments (except for the 30K 


unmapped system). 


Table 4-1 
PDP-1l Processor Memory Sizes for RSX-1L1M/RSX-11S 


Memory Size (in K-word blocks) 


RSX-11M RSX-118S 
PDP-1l1 Processor Minimum _ Maximum Minimum Maximum 
LSI-11, 11/03 Not supported Not supported 8 30 
11/04, 11/05 16 28 16 28 


(Continued on next page) 
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Table 4-1 (Cont.) 
PDP-11 Processor Memory Sizes for RSX-11M/RSX-11S 


Memory Size (in K-word blocks) 


RSX-11M RSX-11S 

PDP-11 Processor Minimum Maximum Minimum Maximum 
11/10, 11/15 (16 28 16 28 
11/20 16 28 16 28 
11/23, 11/24 16 1920 8 1920 
11/40 (no KT-11) 16 28 16 28 
11/44 64 1920 64 1920 
11/70 32 1920 32 1920 
All others (1) 16 124 8 124 


l. In the category "all others," the processors are the PDP-11/34, 
11/35, 11/40, 11/45, 11/50, 11/55, and 11/60. 


NOTE 


Specifying 128K (or more) of memory indicates that you 
have a system with 22-bit addressing. If your target 
PDP-11 processor is a MicroPDP-11, 11/23, 11/23-PLUS, 
11/24, 11/44, 11/70, 11/73, 11/83, or 11/84 and if you 
want to generate a system that is transportable to an 
18-bit processor, you should specify 124K or less. 


* 4. Include support for K-series devices? [Y/N D:N]: 


The K-series laboratory options are a set of real-time data 
acquisition modules that interface to the PDP-11 family of computers. 


Respond Yes if you want support for the K-series software routines 
(see the RSX-11M/M-PLUS I/O Drivers Reference Manual). If you enter 
Yes, SYSGEN automatically includes support for the Connect to 
Interrupt directive and ASTs (asynchronous system traps). 


* 5. Extended arithmetic element (KE11-A/B EAE) present? [Y/N D:N]: 


The extended arithmetic element (EAE) is a hardware feature that 
performs signed integer multiplication, division, multiple-position 
shifts, and normalization. The EAE performs these functions 
significantly faster than software subroutines. 


This question appears only for PDP-11/20 and unmapped (no kKT-11 
hardware) PDP-11/40 systems. 
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* 6. Floating point processor (FP11) present? [Y/N D:N]: 


The PDP-11 floating-point processors perform floating-point arithmetic 
operations and convert data from integer to floating-point format and 
vice versa. 


PDP-1l Processor Floating Point Processor 


11/23, 11/24 — KEF11-AA, FPF-11 
11/34 . FPF11-A 


11/44 FPF11-F 
11/45, 11/50, 

11/55, 11/70 . FPF11-C 
11/60 FPF11-E 


The PDP-11/23 and PDP-11/24 have both a microcode floating-point 

option (KEF11-AA) and a hardware option (FPF-11). Both options are 
fully compatible with the 11/34 floating-point instruction set. Tf 

the target processor is a PDP-11/60, floating-point support is 
automatically included and the question does not appear. 


This question does not appear for other processors. 


This feature should not be confused with the Floating Instruction Set 
(FIS) described in Question 7 of this section. 


If you respond Yes to this question, SYSGEN automatically includes 


Executive support for asynchronous system traps (ASTs). (See Question 
17 in the Executive Options Section.) 


If you respond No to this question, SYSGEN asks Question 7. 
* 7. Floating instruction set (FIS) present? [Y/N D:N]: 


The Floating Instruction Set (FIS) feature includes hardware functions 
that perform floating-point add, subtract, multiply, and divide 
instructions. 


This question appears only if your target system does not have’ the 
floating-point processor (Question 6) and if the target processor is 
one of the following: LSI-11, PDP-11/03, 11/23, 11/24, 11/35, or 
11/40. 
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* 8. Extended instruction set (EIS) present? [Y/N D:N]: 


This question appears only if EIS is standard or optional for your 
particular target processor. Those processors supporting the EIS 
feature are: 


PDP-11l PDP-11 

Processor EIS Feature Processor EIS Feature 
LSI-11 Optional 11/45 Standard 
LSI-11/73 Standard 11/50 Standard 
11/03 Optional 11/55 Standard 
11/23 Standard 11/60 Standard 
11/24 Standard 11/70 Standard 
11/34 Standard 11/73 Standard 
11/35 Optional 11/83 Standard 
11/40 Optional 11/84 Standard 
11/44 Standard KXJ11 Standard 


If you choose this option, some of the following EIS instructions are 
used by the Executive and the I/O drivers, thereby speeding up the 
execution time of the operating system and reducing Executive and I/0 
driver address space. The extended instruction set, which can be used 
by the Executive and I/O drivers, consists of the following 
instructions: 


MUL Multiply 

DIV Divide 

ASH Shift arithmetically 

ASHC Arithmetic shift combined 

XOR Exclusive OR | 

SOB Subtract 1 and branch if not equal to 0 
RTT Return from interrupt 

MFPI Move from previous instruction space 
MTPI Move to previous instruction space 


Note that if you are generating a system that you wish to run on 
different processors, you should be aware that a software system that 
supports EIS instructions does not run on processors that do not have 
EIS hardware. Although your target processor may have EIS hardware as 
a standard feature, this question allows you to exclude EIS SuREOEL so 
that your system is transportable to non-EIS hardware. 
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* 9. If using KW11-P as system clock: number of ints/sec.[D R:0-1000 D:0] 


RSX-11M and RSX-11S require a real-time clock for operations. Three 
clocks are available: 


@ The KW11-P programmable frequency clock 
e The KW11-L line frequency clock 
e The DL11-W line frequency clock/console 


If your system has a KW11-P and you want to use this clock as your 
system clock, the acceptable range is from 0 through 1000(10). 


A response of 0 indicates that there is no programmable clock in this 
configuration or that you want to use the line frequency clock as the 
system clock. 


This question does not appear for the LSI-1l, PDP-11/03, or PDP-11/23 
processors. 


NOTE 


The number of interrupts you select must be evenly 
divisible into 10000(10) 


More than 100(10) clock interrupts-per-second greatly increases system 
overhead. Carefully consider the impact on your system before 
specifying a number greater than 100(10) interrupts-per-second. If 
you do specify more than 100(10) interrupts-per-second and the clock 
is your system clock, you may have to adjust the algorithms for the 
other clock functions (for example, round-robin scheduling and disk 
swapping). Adjusting the algorithms compensates for the system 
overhead caused by the high number of interrupts-per-second. If you 
need the clock for time-critical tasks, it is recommended that’ the 
clock not be your system clock, too. 


* 10. Line frequency: A- 60Hz B- 50Hz [D: A] [S]: 


Specify a line frequency of either 50 or 60 Hz. In the U.S.A., line 
frequency is always 60 Hz. The default response is 60 Hz. 


If a KW11-P programmable frequency clock is available and if you have 


selected the Autoconfigure option (Setup Question 1), Autoconfigure 
computes the line frequency. 


* 11. KW1ll-yY Watchdog timer support? [Y/N D:N]: 


The KW11-Y watchdog timer is a hardware clock that constantly attempts 
to time out system activity. The Executive refreshes the timer at 
every clock interrupt. If the system faults or if a hardware failure 
occurs and the timer expires, a message indicates that the system has 
been corrupted. 


This question always appears. 
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* 12. Memory parity support? [Y/N D:N]: 


Respond Yes if your system includes parity memory and if you want 
Executive support to detect parity errors. 


If you intend to log cache and memory-parity errors, you must answer 


Yes to this question. (See Question 24 of the Executive Options 
Section.) 


Memory-parity support uses approximately 200 words of memory. 


If you respond Yes to this question, SYSGEN asks Question 13. 
* 13. Cache memory? [Y/N D:NJ: 


Cache memory is standard on PDP-11/44, 11/60, and 11/70 processors. 
Cache memory is optional on the PDP-11/34. 


Respond Yes if you want Executive support to detect parity errors. 


This question appears only for the previously specified processors 


when you select memory-parity support (Question 12) for those 
processors. 


* 14. Highest interrupt vector [0 R:0-774 D:0]: 


The response to this question specifies the highest interrupt vector 
address. If you respond with 0 (or press RETURN) or with an even 
value less than 400(8), SYSGEN calculates this address based on your 
answers to the peripheral questions that occur later in Phase I. The 
end of the vector area is minimally set to 400(8) bytes. If it is 
necessary for you to specify the end of the vector area yourself, 
remember that some devices (notably DLs and DZs) have two vectors: 
one for input and one for output. Check the PDP-11 Peripherals 
Handbook or the Terminals and Communications Handbook if you are 
uncertain. = 


If you intend to include any devices in your target system that have 
an interrupt vector greater than 400(8) (such as K-series and certain 
communications devices), specify an even value for the highest 
interrupt vector that you need to accommodate those devices at this 


time. 
NOTE 
SYSGEN does not write this value to the saved answer 


file until you complete the Peripheral Options 
Section. 


This question always appears. 
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* 15. Devices [SJ]: 


This question asks you to enter, in mnemonic form, the peripherals and 
‘pseudo devices for your target configuration. SYSGEN generates 
questions only for those devices you specify in response to this 
question. 


NOTE 


If you chose the Autoconfigure option, you can add new 
devices, you can add devices not found by 
Autoconfigure, and you can exclude any devices already 
found by Autoconfigure. 


Enter devices in the form: 
device=number of controllers 


where device is the device mnemonic and controllers is the number of 
controllers for the device type. If you omit the controller entry 
(=controllers) , SYSGEN assumes one controller for that device type. 


Generally, there may be one controller for several devices of a given 
type. For example, four RA80 drives can be connected to one UDA50O 
controller. In this case, all you are required to enter in response 
to this question is DU. SYSGEN defaults to one controller for all 
four RA80 drives. 


To help select the appropriate device mnemonic, enter an asterisk (*) 
to generate a list of devices. 


You can display your current configuration (the device mnemonics’ and 
number of controllers) by entering a question mark (?). 


If you chose the Autoconfigure option, SYSGEN prints the list of 
devices that Autoconfigure found before this question is asked. If 
you are satisfied with Autoconfigure's results, enter a period (.) in 
response to this question. 


If you are not satisfied with Autoconfigure's results, you can add new 
devices, modify existing devices, and delete any devices’ that 
Autoconfigure found. Those devices you specify are the only devices 
affected in the Target Configuration saved answer file. 
Autoconfigure's results remain the same for the rest of the hardware 
configuration. 


When you have entered all of the devices and controllers for your 
target system, and have made any necessary corrections, terminate your 


response by entering a period (.) either following the last controller 
or on a line by itself. 


If you make a mistake and specify a device type that is not included 
in the target configuration, enter device=0 (see the following 
example). Also, if you specify the wrong number of controllers, you 
can correct this by reentering the device type and the new number of 
controllers. SYSGEN uses 4-2 the most recent response for duplicate 
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entries. For example, if your system includes two RK11 controllers 
and one TCll DECtape controller, the following sequence corrects an 
incorrect response of three RK11s, two TU56s and one RLI1I1: 


Devices: DK=3 
Devices: DT=2 
Devices: DL 
Devices: DK=2 
Devices: DT 
Devices: DL=0 
Devices: . 


(defaults to 1) 

(supersedes previous value of 3) 
(supersedes previous value of 2) 
(removes previously specified RL11) 
(terminates input) 


Table 4-2 lists the peripheral devices supported by RSX-11M: 


Table 4-2 
Peripheral Devices Supported by RSX-11M 


Mnemonic Device Hardware Controller 

AD Analog-to-Digital Converter ADO1-D 

AF Analog-to-Digital Converter AFC11 

AR Laboratory Peripheral Subsystem ARI1 

CR Card Reader CR11/CM11-E 

CT TU60 Cassette TALL 

DB RP04/05/06 disk packs RH11/RH70 

DD TU58 DECtape II DL11 

DF RF1l disks RF11 

DK RKOS/J/F cartridge disk RK11 

DL RLO1 disk drive RL11/RLV11 
RLO2 disk drive RL21/RLV21/RLV12 

DM RKO6/07 cartridge disk RK611/RK711 

DP RP02/03 disks RP11/RP11C 

DR RM02/03/05 disks and RH11/RH70 
RM80 fixed media RH70 

DS RS03/04 fixed-head disks RH11/RH70 

DT TU56 DECtape TCll 

DU RA60 removable media UDA50/KDA50-Q 
RA80/81 fixed media UDA50/KDA50-Q 
RC25 fixed/removable media RC25 
RD51 fixed media RQDX1 
RD52 fixed media ROQDX1 


(Continued on next page) 
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Mnemonic 


DX 
DY 
EM 
GR 
Ic 
Is 
LA 
LP 
LS 
MM 
MS © 
MT 
MU 
PP 
PR 
UD 
XB 
XE 
XL 
XM 
XP 
XQ 


XU 


Table 4-2 (Cont.) 


Peripheral Devices Supported by RSX-11M 


Device 


RD53 fixed media 

RX50 diskette 

RX180 IBM-compatible diskette 

RxX01 diskette 

RX02 diskette 

ML11 Nonrotating Electronic Memory 
Graphics Display Processor and Scope 
Industrial Control Subsystem 
Industrial Control Subsystem 
Laboratory Peripheral Accelerator 
Line Printer 

Laboratory Peripheral Subsystem 
TU45/TU1L6/TE16/TU77 magnetic tapes 
TS11/TSV0O5/TU80 magnetic tapes 
TSO3/TU1O/TE1O magnetic tapes 

TK50 streaming cartridge tape 
Paper Tape Punch 

Paper Tape Reader 

Universal Digital Controller 
Interprocessor Link 

UNIBUS Ethernet Controller 
Interprocessor Link 

Interprocessor Link 

Synchronous Interface 

Synchronous Interface 


Synchronous Interface 


Hardware Controller 


RQDX3 
RQDX1/RUX50 
RUX50 

RX11 

RX211/RXV21 

RH70 

VT11/VS60 
ICR/ICS11 
DRS/DS11 

LPA11-K 
LA11/LP11/LS11/LV11 
LPS11 
RH11/RH70/TM02/TM03 
TS11 
TM11/TMA1L/TMB11 
TOK50 

PC11 

PC11/PR11 

UDC11 

DA11-B 

DEUNA 

DL11-E 
DMC11-E/DMR11 
DP11 

DQ11 


DU11 


(Continued on next page) 
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Table 4-2 (Cont.) 
Peripheral Devices Supported by RSX-11M 


Mnemonic Device Hardware Controller 
XW Synchronous Interface DUP11 

YH Asynchronous Terminal Interface DH11 

YJ Asynchronous Terminal Interface DJ11 

YL Asynchronous Terminal Interface DL11/A/B/C/D/E/J /W 
YV Asynchronous Terminal Interface DHU11/DHV11 

YZ Asynchronous Terminal Interface DZ11/D2Q11/D2ZV11 


Pseudo devices: 


CL Console Listing Pseudo Device N/A 

Co Console Output Pseudo Device N/A 

LB Library Default Pseudo Device N/A 

NL Null Device N/A 

SY ' System Default Pseudo Device N/A 

TI Terminal Input Pseudo Device N/A 
NOTE 


If you intend to perform future system generations 
using your target system, you must include the NL 
pseudo device. 


If you are generating RSX-11M, SYSGEN forces YL into the system. 
Normally, you must specify any pseudo devices if you want to include 
them. In addition, SYSGEN forces the null device (NL:) into a system 
only if (1) that system does not include an asynchronous terminal 


interface and (2) if that system includes at least one of the 
following disks: DB:, DEF:, DK:, DL:, DM:, DP:, DR:, DS:, DX:, DY:, 
DU:, or EM:. Otherwise, you must explicitly select NL: (which is 


necessary if the new system will be the host system for a later 
SYSGEN). 


If you specify CO, you get the Console Logger task and the CO driver. 
If you do not specify CO, SYSGEN automatically includes the pseudo 
device CO without the Console Logger task and the CO driver. See _ the 
RSX-11M/M-PLUS System Management Guide for details on the differences 
between the CO driver and the CO pseudo device. 
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CO is not available on unmapped systems or on RSX-11S systems. 


GR is not valid on systems with more than 124K of memory. 


NOTE 


To specify the number of paper tape device 
controllers, you must consider the PCll reader/punch 
as two separate devices, a reader (PR) and a= punch 
(PP). Enter both a PR and a PP for each PC1ll, but 
only a PR for each PR1I1. 


» 


DETAILS OF SYSGEN PHASE I 


HOST CONFIGURATION 


4.4 HOST CONFIGURATION SECTION 


Your responses to these questions define the configuration on which 
you are running SYSGEN. 


* 1. Is a line printer available? [Y/N]: 


This option allows you to specify the device to which maps and 
listings will be directed. 


If you respond Yes, you may direct SYSGEN to spool listings and maps 
to the line printer. 


If you respond NO, SYSGEN directs listings and maps to your terminal. 
* 2. Spool assembly listings and Executive and driver maps? [Y/N]: 


This option allows you to specify whether or not to spool listings. 
For example, you can direct listings to an intermediate device. 
Spooling the listings to an intermediate device allows you to save the 
listings without the risk of filling up the distribution disk. 


If you want the listings spooled to the line printer, respond Yes’ to 
this question. 


If you respond Yes, Question 1 (List Executive map?) of the Executive 
Task-Build Section is not asked. 


If you want to save the listings but not spool them, respond No to 
this question (see Question 5). 


This question appears only if you responded Yes to Question 1 and if 
you are generating your system from an on-line host computer. 


* 3. Does the listing/map device have at least 120 columns? [Y/N]: 


If the listing device does not have at least 120 columns, SYSGEN 
creates a narrow listing for assembly and map listings. For 
information on narrow listings, refer to the descriptions of the /LI 
switch for MACRO-1l and the /WI = switch in the RSX-11M/M-PLUS and 
Micro/RSX Task Builder Manual. i 


* 4. Assembly listing file device (ddu:) [D: NL:]: 


This option allows you to choose whether or not to direct listings to 
an RSX-11M logical or pseudo device or to not generate them at all. 


Specify LP: to direct the listings to the line printer if you are 
running stand-alone, to a disk device (ddu:) if you are running 
on-line, and NL: (the null device, and the default) to direct SYSGEN 
not to produce assembly listings. 
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NOTE 
The only driver that SYSGEN loads is the LP: driver. 


If you are generating your system with either an 
RKO6/RKO7 or RLOL/RLO2Z distribution kit, do not direct 
your assembly listings to any of the distribution kit 
disks. There is not sufficient space on those kits. 


* 5. Map device for Executive and device drivers (ddu:) [D: <default>]: 


The response to this question defines the default device to which you. 
want to direct the Executive and device driver maps. You should 
specify a device other than the system disk for these maps. 


For unmapped systems, you should specify a device since the maps are 
necessary to determine the size of the Executive and device drivers 
and to lay out memory partitions in SYSGEN Phase II. 


If you are using an RLO1L/RLO2 distribution kit, the map device must be 
the device where the PRVBLD disk will be mounted in Phase II. If you 
are chaining from Phase I to Phase II, the default is the device 
specified for Question 17 (for the PRVBLD disk). If you are not 
chaining, the default is the device on which EXCPRV is’ currently 
mounted. If the PRVBLD disk will be mounted on another drive, you 
should respond to this question with the device on which PRVBLD will 
be mounted. 


If you are using either an RKO6/RKO7 or a big-disk distribution kit, 
the default response is SY:. 


Unless you are performing a PREPGEN, you must mount (using the MCR 
MOUNT command) the disk to which you are directing map listings before 
you invoke Phase II. That disk must contain directory [1,34] for a 
mapped system or [1,30] for an unmapped system. If you direct SYSGEN 
to chain directly to Phase II, you must mount the map listing disk 
before you invoke Phase I. 
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4.5 EXECUTIVE OPTIONS SECTION 


Your responses to these questions define the RSX-11M Executive options 
you want included in your target system. 


The RSX-11M/M-PLUS and Micro/RSX Executive Reference Manual describes 


—_—_ ——————— 


some of these directives and Executive options. 


Answer Yes to the features you want included in your system. 
* 1. Include support for DBMS-11? [Y/N]: 


For details on DBMS-1l, refer to the DBMS-11 documentation. 


This question appears only if the target processor memory is greater 
than 96K, the system is mapped, and you are generating RSX-11M. 


If you select DBMS-11 support, SYSGEN automatically includes Executive 
Support for: 


e Files-11 ACP 
@ RMS-11 bucket eeking and placement control 
@ Memory management (PLAS) directives 
e Send/Receive By Reference directives 
e Asynchronous system traps (AST) 
e System-controlled partition support 
e The following system directives: 

- Get Partition Parameters (A) 

~- Get Task Parameters (B) 

- Send/Receive (C) 

- Extend Task (E) 


- Stop-bit (I) 


Parent/offspring tasking (K) 


See Questions 2, 3, 7, 8, 17, 33, and 37, respectively. 
* 2. FILES-11 ACP? [Y/N]: 


You must select Files-11 ACP (FCP) if you want to include the services 
described in the RSX-11M/M-PLUS I/O Operations Reference Manual or if 
you intend to include RMS-1l or any file functions of a high-level 


language. DIGITAL-supplied software uses the FCP. You should select 
this option. 
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If you selected DBMS-11 support, SYSGEN automatically includes’ this 
option. 


If you are generating an RSX-11S system, this question does not appear 
and an FCP is not included in your system. 


If you choose this option, Question 4 of the System Options Section 
asks you to specify a version of the FCP. 


* 3. Bucket locking (file sharing) and placement control? [Y/N]: 


If Files-1l ACP (FCP) is included in your system either by default or 
because you selected it in Question 2, SYSGEN asks this question to 
provide the necessary Executive and FCP support. 


If you do not choose this support, file sharing and placement control 
are not included in your system. 


This option adds approximately 200(10) words to the size of the 
Executive. 


This option is not available for RSX-11S systems. 
* 4, Non-resident tasks (task loader) [Y/N]: 


It is highly recommended that you select this option. Nonresident 
task support. allows tasks that are not permanently resident in your 
system to be loaded from disk. 


If you do not include support for the task loader, all tasks must be 
installed and fixed into the system image by VMR. 


If you answer No, Question 5 (loadable task loader) does not appear. 


This question does not appear if you are generating an RSX-11S system. 
* 5. Loadable task loader? [Y/N]: 


The RSX-11M task loader reads tasks scheduled for execution from disk. 
The loadable task loader is an RSX-11M Executive feature that reduces 
the amount of address space required for the Executive (excluding 
pool). This feature frees space for additional Executive dynamic 
storage. 


If you answer No to this question, SYSGEN task builds the loader into 
the Executive, which requires up to 2400 bytes of Executive virtual 
address space. The system uses the corresponding amount of main 
memory to hold the loader as a fixed privileged task. By choosing the 
loadable task loader option, those 2400 bytes become available for use 
as dynamic storage (pool space) or for other Executive features. 


This option does not appear for RSX-11S systems, unmapped systems, or 
systems that do not support nonresident tasks. 
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* 6. Executive Common? [Y/N]: 


If you choose this option, much of the Executive's directive support 
code will be set in external memory-resident commons rather than being 
resident in the Executive itself. These memory-resident commons’ free 
more of the Executive's address space, which can then be used for 
additional pool space. 


The Executive commons are two 4K-word partitions. However, the 
potential space available for the Executive commons is not totally 
utilized. VMR calculates the actual size of the Executive commons 
(based on which Executive options you select in this section) and 
allocates the necessary amount of memory for the Executive commons 
during Phase II. Generally, VMR allocates about 5.5K words as the 
combined size of both Executive commons. 


The cost of choosing the Executive commons is that the Executive 
commons occupy the equivalent amount of memory that they would 
otherwise occupy in the Executive. The file SYSVMR.CMD includes a SET 
/POOL command that always creates the maximum possible pool space for 
a mapped target system. 


SYSVMR.CMD may create more pool space than your system requires, 
particularly if you choose the Executive Common support. This extra 
pool space directly impacts the amount of memory available for your 
applications. However, you can remedy this during Phase II by editing 
SYSVMR.CMD and modifying the SET /POOL command. Should the modified 
pool size subsequently prove to be inadequate for your system's needs, 
you can remodify the SET /POOL command to allocate more pool up to the 
limits of the Executive's permanently mapped virtual address space 
(normally 20K). Remember, any time you modify the contents of 
SYSVMR.CMD, you must recreate the system image, then reinvoke 
SYSVMR.CMD. (See Example 5-1 at the end of Chapter 5 for details on 
creating the system image file.) 


This question appears only for mapped systems with at least 36K words 
of memory. 


(i i Memory management (PLAS) directives? [Y/N]: 


Memory management (PLAS) directives provide functions that allow tasks » 
to dynamically modify mapping of their physical addresses in memory. 
These directives also allow tasks to dynamically create and delete 
common blocks. 


The following lists the memory management directives: 


Attach Region Get Mapping Context 
Create Address Window Map Address Window 
Create Region Receive By Reference 
Detach Region Send By Reference 
Eliminate Address Window Unmap Address Window 
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Memory management directives are restricted to use on mapped. systems. 
Therefore, the question does not appear for unmapped systems. 


If you select DBMS-11 (Question 1), SYSGEN includes memory management 
directives by default and does not ask this question. 


If you do not select memory management directives, you cannot include 
Executive support for Send/Receive By Reference directives (Question 
8) or the Get Mapping Context directive (Question 9). 


The memory management directives add approximately 1000(10) words to 
the Executive. 


* 8. Send/Receive By Reference directives? [Y/N]: 


The Send/Receive By Reference directives allow one task to send to 
another task a reference to an area within a region. The receiver 


task is given a specified access that allows it to map to or delete 
the region. 


If you selected DBMS-11 and memory management (PLAS) directive 
support, SYSGEN automatically includes Executive support for the 
Send/Receive By Reference directives. This question does not appear. 
If you did not include support for the memory management directives, 
this question does not appear. 


* 9, Get Mapping Context directive? [Y/N]: 


The Get Mapping Context directive returns parameters to the issuing 
task that describe the current window-to-region mapping assignments. 
These parameters allow you to restore the mapping context by using the 
memory management Create Address Window directive. 


This question appears only if you selected support for memory 
management (PLAS) directives (Question 7). 

* 10. Address checking? [Y/N]: 

Address checking directs the Executive to perform boundary checks’) and 
alignment checks on addresses issued by users in Executive directives. 


If you are generating a mapped system, SYSGEN automatically includes 
address checking and does not ask this question. 


Address checking is recommended unless you are running a fully 
debugged application system. 


* 11. I/O rundown? [Y/N]: 


I/O rundown ensures RSX-11M system integrity by completing all 
outstanding task-related I/O before allowing a task to exit. 
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If you are generating a mapped system, SYSGEN automatically includes 
support for I/O rundown and does not ask the question. I/0 rundown is 
recommended unless you are running a fully debugged application 
system. 


* 12. Multiuser protection? [Y/N]: 


This feature prevents tasks initiated at one terminal from interfering 
with tasks initiated at other terminals. Multiuser protection 
provides for public and private devices and login and logout with 
password protection. 


When you select this feature, SYSGEN includes support for 
checkpointing with the system checkpoint file. In addition, SYSGEN 
automatically includes the following terminal driver features: 


@e Read with special terminator 
e Break-through write 

@ Read with no echo 

e@e cCTRL/R support 


Multiuser protection increases the size of the Executive by 
approximately 100(10) words. 


Select multiuser protection support only if your system has 32K or 
more of main memory. If your target system is unmapped, it is 
recommended that you not select this option. 


Multiuser protection support is not available on an RSX-11S system. 
The question does not appear. 


* 13. ANSI Magtape ACP? [Y/N]: 


This feature provides support for volume and file labels that conform 
to the ANSI standard (X3.27-1978) for industry-compatible tapes. This 
feature requires Executive AST support. If you select ANSI magnetic 
tape ACP support, SYSGEN automatically includes AST support. 


ANSI magnetic tape ACP support increases the size of the Executive by 
approximately 40(10) words. If you select this option, SYSGEN task 
builds F1l1MSG (the magnetic tape error processor), MTAACP (the 
Magnetic tape Ancillary Control Processor), and MAG (the magnetic tape 
ACP control task). 


In addition, if you select ANSI magnetic tape support, SYSGEN 
generates a second library called ANSLIB.OLB. This library 
(ANSLIB.OLB) contains an FCS that communicates with the ANSI magnetic 
tape ACP. This FCS also supports the FCS big buffering feature. See 
the RSX-11M/MPLUS I/O Operations Manual for more information. 


If you respond Yes, support for the Send/Receive directive is 
included. 
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If you do not select ANSI magnetic tape support, the system library, 
SYSLIB.OLB, contains an FCS that does not communicate with the ANSI 
Magnetic tape ACP. 


RSX-11S systems do not support ANSI magnetic tapes. The question does 
not appear. 


* 14. Do you want on-line formatting (FMT) or diagnostic QIOs? [Y/N]: 


Diagnostic QIOs enable the Executive and device drivers to perform 
special I/0 functions and return additional device status information 
required by on-line diagnostic tasks. FMT is one utility that uses 
those special I/O functions. 


If you intend to either do on-line disk formatting or write your own 
hardware diagnostic routines, you should answer Yes to this question. 
See the RSX-11M/M-PLUS Utilities Manual for information on the on-line 
formatter (FMT) and the RSX-11M/M-PLUS Ifo Drivers Reference Manual 
for a description of QIOs. 


This feature is not available for RSX-11S systems. The question does 
not appear. 


* 15. Loadable device drivers? [Y/N]: 


This option allows you to load and unload most device drivers 
dynamically using MCR and VMR LOAD and UNLOAD commands. All drivers 
except the industrial and process control device drivers (UDC, 
ICS/ICR, and DRS/DSS) and the VT11/VS60 graphics driver are loadable. 


Note that the full-duplex terminal driver requires loadable device 
driver support. Therefore, if you wish to include the full-duplex 
terminal driver, you must include loadable driver support. 


When you select this option, SYSGEN generates loadable device drivers. 
However, SYSGEN makes all data bases resident. 


If you respond No, SYSGEN links all device drivers generated for your 
system into the Executive, making them all resident. This impacts the 
potential amount of pool space available to your system. 


SYSGEN always asks this question. 


* 16. Should the default for all applicable drivers be loadable? [Y/N]: 


If you included loadable device driver support, responding Yes to this 
question specifies that all drivers (except UDC, ICS/ICR, DRS/DSS, and 
VT11/VS60) are to be built as loadable by default (you can override 
the default in the Peripheral Options Section). 


The response to this question sets the default, either L (loadable) or 
R (resident), for the first parameter in some responses to peripherals 
questions. You can override this default in your responses to the 
questions in the Peripheral Options Section. 
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If you respond No to this question, SYSGEN builds all drivers (except 
the full-duplex terminal driver, if selected) as resident. 


If you do not choose loadable device driver support in Question 15, 


all drivers will be resident. You cannot override that condition in 
the Peripheral Options Section. . 


* 17. Include Support for Asynchronous System Traps (AST)? [Y/N]: 


This option allows the processing of asynchronous system traps. 


Support for ASTs is automatically included if you previously selected 
any of the following: 


e The ANSI magnetic tape ACP support 
e The Floating Point Processor (FP11) 
e DBMS-11 
e The LA driver (LPA11-K) 
e The K-series device support routines 
Respond Yes if you want AST support. 
If you respond No, the terminal driver cannot support unsolicited 


input character ASTs. (See Question 6 in the Terminal Driver Options 
Section.) 


* 18. Include support for Cancel Selective Marktime? [Y/N]: 


If you select this option, you can selectively cancel specific 
marktime requests. See the CMKTS directive in the RSX-11M/M-PLUS and 
Micro/RSX Executive Reference Manual for information on the Cancel 
Marktime directive. 


If you do not select support for Cancel Selective Marktime, any 
attempt by a task to cancel a marktime results in the cancellation of 
all outstanding marktimes for that task. 


If you selected support for DBMS-11, SYSGEN automatically includes 
support for Cancel Selective Marktime. 


* 19. Task termination and device not ready messages (TKTN)? [Y/N]: 


This option directs the system to generate on the input device and on 
the console "Device not ready" and task termination messages when 
these conditions occur. 


You must select this option if you want Postmortem Dump (PMD) and 
snapshot dump (SNAPS) support or Logging of Task Abort support. 
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* 20. Power fail recovery? [Y/N]: 


This option provides for automatic system recovery in the event of 
power failure. Device drivers and tasks that specify a power recovery 
AST are notified when power returns. 


There are three possible recovery procedures: 


e If a device was busy prior to the powerfail and the requested 
I/O had not completed, the routine times out and checks the 
device status until the device is "ready" for I/0 operations 
to resume. 


e If a device was not busy prior to the powerfail and receives 
an I/0 request after the powerfail, the routine times out and 
checks the device status until the device is "ready" for I/0 
operations to resume. 


e If a device was not busy prior to the powerfail and there are 
no pending I/0 requests, operations resume with no special 
handling by the recovery routine. 


Note in the first two cases, if the maximum timeout count is_ reached 
before the disk spins back up and is “ready," an unsuccessful I/0 
completion code is returned. 


This option is required to support the Specify Power Recovery AST 
directive. 


* 21. Install, request, and remove on exit? [Y/N]: 


This option (the MCR RUN command) reduces the number of installed 
tasks in memory, thereby optimizing the use of system memory resources 
and minimizing use of pool. See the RSX-11M/M-PLUS MCR Operations 
Manual for information on the RUN command. 


This feature is not available for RSX-11S systems. The question does 
not appear. 


* 22. Large (20K) Executive? [Y/N]: 


This option allows you to generate a 20K Executive to increase the 
size of the Executive's virtual address space (typically, to provide 
more pool). This reduces to 8K the maximum size of privileged tasks 
that map the I/O page. 


If you are generating an unmapped system, this question does not 
appear. 
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* 23. Logical device assignment? [Y/N]: 


This option is highly recommended. If you intend to use your’ target 
system for subsequent SYSGENs, you must answer Yes to this question. 


This option (the MCR ASN command) allows you to assign a logical name 
to a physical, pseudo, or other logical device. Assignments may be 
made on a per terminal (local) or system-wide basis (global). See the 
RSX-11M/M-PLUS MCR Operations Manual for details on the ASN command. 


* 24. Include support for error logging? [Y/N]: 


If you choose this option, the Executive logs information on disk and 
tape device errors and time-outs, logs information on traps to 
undefined interrupt vectors, and logs cache and memory parity error 
traps. The Error Logger task stores the recorded information in a 
disk file for later analysis. See the RSX-11M/M-PLUS Error Logging 
Manual for detailed information. 


Error logging is most useful for detecting intermittent faults on 
large systems. Error logging support adds approximately 700(10) words 
of code to the Executive. 


SYSGEN supports error logging only for the following devices: 


CT: DK: DR: DX: MM: 
DB: DL: DS: DY: MS: 
DD: DM: DT: EM: MT: 
DF: DP: DU: MU: 


When you select this option, SYSGEN includes. support for 
checkpointing, the Send/Receive directives, and for nonresident tasks. 


If you did not select memory parity support (Question 12 of the Target 
Configuration Section), the Error Logger task does not record cache or 
memory parity errors. 


Error logging is not available for RSX-11S systems. The question does 
not appear. 


* 25. Do you intend to include a user-written driver? [Y/N]: 


This question should be answered No if you do not intend to include a 
user-written driver in your target system. A user-written driver is a 
non-DIGITAL supplied and non-DIGITAL supported driver. See the 
RSX-11M Guide to Writing an I/O Driver for a complete discussion of 


SYSGEN support for user-written drivers. 


You should answer Yes if you want the user-written driver to be memory 
resident. 


If you respond Yes, SYSGEN asks Questions 26 and 27 concerning’ the 
Executive routines SGTWRD (Get Word) and SPTWRD (Put Word). 
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* 26. Include routine SGTWRD? [Y/N]: 


This option (the SGTWRD Executive routine) allows you to obtain a word 
from a user-defined buffer. See the RSX-11M Guide To Writing an I/0 
Driver for information on how to use this routine. 


If you have included LA: (LPA11-K) as one of the specified devices, 
SYSGEN automatically includes support for the SGTWRD routine. Also, 
SYSGEN includes support for the Send/Receive directive. 


This question does not appear if you responded No to Question 25 (you 
do not intend to include a user-written driver). 


* 27. Include routine S$PTWRD? [Y/N]: 


This option (the S$PTWRD Executive routine) allows you to send a word 
to a user-defined buffer. See the RSX-11M Guide To Writing an I/0 


If you have included the AD: (ADO1-D) or AF: (ACF11) subsystem (see 
Appendix C) as one of the specified devices, SYSGEN automatically 
includes support for the SPTWRD routine. 


This question does not appear if you responded No to Question 25 (you 
do not intend to include a user-written driver). 


* 28. Disk writecheck? [Y/N]: 


Write-checking support increases the data reliability of disks. The 
added activity of disk write-checking does, however, diminish the 
speed of disk throughput. If selected, write-checking may be enabled 
or disabled dynamically on a per-drive basis with the MCR SET command. 


SYSGEN supports disk write-checking for the following devices: 
DB DF DK DL DM 
DP DR DS DU EM 


If your target system configuration does not include any of these 
devices, the question does not appear. 


NOTE 


If you include write-checking support and want to use 
‘it, you must issue the MCR SET /WCHK=ddnn: command 
after you complete SYSGEN. This command causes’ the 
driver to perform a write-checking function after each 
write operation. For more information on the MCR’ SET 
/WCHK command, see the RSX-l11M/M-PLUS MCR Operations 
Manual. 
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This is how the write-checking function works. After the data is 
written to disk, the disk controller reads a copy of that data from 
memory, word by word, while simultaneously reading a second copy of 
that data from the disk, and does an exclusive OR (XOR instruction) to 
compare them. If the write-checking function fails (that is, if the 
copies compared are not the same), the driver retries the original 
write operation and performs another write-check until the maximum 
retry count is reached (at which time the system issues the hard error 
message IE.WCK). 


RSX-11S does not support disk write-checking. The question does not 
appear. 


* 29. Software write-lock support? [Y/N]: 


If you respond Yes to this question, SYSGEN includes Executive support 
for the MCR MOUNT /[NO]WRITE command. The MCR MOUNT /[NOJWRITE 
command allows you to gain control over write access to a _ specified 
mass storage device. See the RSX-11M/M-PLUS MCR Operations Manual for 
a complete description of the MCR MOUNT /[NO]WRITE command. 


The MOUNT /[NO]WRITE command can be used for software write-locking 
the following mass storage devices: 


Disks: 
DB DF DK DL DM 
DP DR Ds DU EM 


Magnetic Tape: 


MM MS MT MU 
DECtape: 

DD DT 
Cassette: 

cr? 


Support for software write-locking adds approximately 40(10) words to 
the size of the Executive. 


This option is not available for RSX-11S systems. 
* 30. Executive Debugging Tool (XDT)? [Y/N]: 


The Executive Debugging Tool (XDT) provides a subset of ODT-11l 
commands to be used in the system state. See the RSX11-M/M-PLUS and 
Micro/RSX Debugging Reference Manual for details on XDT. 


If you respond Yes, SYSGEN includes XDT in the Executive to allow 
interactive debugging of Executive modules, privileged tasks, I/0 
drivers, and interrupt service routines. 
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This option includes consistency checking in the dynamic. storage 
region (pool) routines. The routines are used to detect corruption of 
pool pointers. Also included is code to trap I/O process corruption 
from drivers. 


XDT adds approximately 1K words to the size of the Executive. 

* 31. Rotating pattern in data lights? [Y/N]: 

This option causes the PDP~1l CPU lights to rotate in a circular 
pattern when the processor is idle. 

This option is available only on the PDP-11/45, 11/50, 11/55, and 
11/70 processors. 

+ 32. Include support for communications products (such as DECnet)? [Y/N]: 
This option allows you to include DECnet or DPM/DPM-PLUS' support. 
Refer to the DECnet or DPM/DPM-PLUS documentation for details. 


If you respond Yes, SYSGEN includes the support necessary for the 
following products: ; 


e@ DECnet-11M 
@e RSX DLX-1l 
@ RSX-11 PSI/CAN (X.25 packet-switched interface) 
@e RSX-11 PSI/FR (X.25 packet-switched interface) 
e@e RSX-11M SNA PROTOCOL EMULATOR 
@e RSX-11 3271 PROTOCOL EMULATOR 
When you respond Yes, SYSGEN also automatically includes: 
@e FCP support 
e AST (asynchronous system trap) support 
e Cancel Selective Marktime support 
e Logical device assignment support 
@e Loadable device driver support 
e Address checking support 
e Get Partition Parameters directive support 
e Get Task Parameters directive support 
e Send/Receive directive support 
e Extend Task directive support 


e Asynchronous buffered I/O support 
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When you respond Yes, the following message appears on your terminal: 


If you will be generating DECnet into this system, 
be Sure you have read the section on SYSGEN 
requirements in the RSX DECnet Network Generation 


and Installation Guide. Several DECnet features 
(e.g., remote terminal support, 11S task 
loading/upline dumping, etc.) require special 


consideration during SYSGEN. 
* 32A. Include Network Command Terminal support? [Y/N]: 


This question appears only if you chose support for DECnet in Question 
32 (include communications products?). 


If you respond Yes, the full-duplex terminal driver supports modem 
hangup ASTs, out-of-band character ASTs, switch characters, extended 
I/O, and internal I/O completion. 


* 33. System-controlled partitions? [Y/N]: 


This option allows the Executive to allocate available space in memory 
to accommodate as many tasks as possible at any one time. Unlike 
user-controlled partitions where the user must define subpartitions to 
run multiple tasks within a main partition, the Executive allocates 
the space for the tasks within a system-controlled partition. 


System-controlled partitions are most effective when combined with the 
Shuffler (SHF). 


If you selected DBMS-11 support (Question 1), SYSGEN automatically 
includes support for system-controlled partitions and, therefore, 
bypasses this question. 


This option is not available for unmapped systems or for RSX-11S. 
* 34. Include support for the Shuffler? [Y/N]: 


The Shuffler (SHF) is a privileged task designed to minimize 
fragmentation within system-controlled partitions. The Shuffler 
requires Executive support to run. 


If you respond Yes to this question, SYSGEN builds the Shuffler task 
(SHF) and includes it in your system image. 


The Shuffler is not available for unmapped systems or for RSX-11S. If 
you did not select system-controlled partitions, this question does 
not appear. 


For more detailed information on using the Shuffler, refer to _ the 
RSX-11M/M-PLUS System Management Guide. 
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NOTE 


If you intend to include the Shuffler in your target 
system, it should not be installed in a 
system-controlled partition. 


* 35. Queue manager and queued print spooler? [Y/N]: 


This option allows you to provide user-controlled spooling support for 
RSX-11M systems. See the RSX-11M/M-PLUS Batch and Queue Operations 
Manual for a description of the features of RSX-11M print sSpoolers. 


If you respond Yes, the required support is built into the Executive. 
If you respond No, you will be asked in the System Sperone Section 
whether or not you want to build the serial despooler. 


When you respond Yes, SYSGEN automatically includes: 
e Stop-bit directive support 
@ Send/Receive directive support 
e Parent/offspring tasking directive support 


This option is available only for mapped RSX-11M systems. 
* 36. Group global event flags? [Y/N]: 


This option makes available 32(10) additional event flags for each 
user group on the system. Group global event flags are in addition to 
a single member's local event flags. In the UIC [303,26], for 
instance, 303 indicates the group number; the number 26 indicates one 
member in the group. If the members in group 303 were running a 
system that supported group global event flags, there would be 32 
additional event flags to be shared among the members in the 303 
group. Another group, say 300, would have 32 additional event flags 
to share among the members of that user group. 


If you select this option, you get full support for Group Global Event 
Flag directives as well. 


For more information on group global event flags, refer to the 


LL ST 


* 37. Enter code for system directives 


This option includes system directives. Each directive is indicated 
by an associated letter code: 


A-Get Partition Parameters G-Get Sense Switch 
B-Get Task Parameters H-Set System Time 
C-Send/Receive I-Stop-bit 
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D-Alter Priority J-Specify Requested Exit AST 
E-Extend Task K-Parent/offspring tasking 
F-Connect to Interrupt Vector L-Parent/offspring tasking 


with chaining 


‘Enter an asterisk (*) to display the table of directives. Enter a 
percent sign (%) to include all directives. Enter a period (.) to 
terminate the question. 


If you enter %, SYSGEN includes all valid directives listed here and 
proceeds immediately to the next question. In this case, there is no 
need to terminate input with a period (.). 


Refer to the RSX-11M/M-PLUS and Micro/RSX Executive Reference Manual 
for descriptions of the directives. 


NOTE 


If you do not select Get Partition Parameters (option 
A) and Get Task Parameters (option B), the MCR ASN, 
ATL, DEV, PAR, TAL, and TAS commands” and many 

- DIGITAL-supplied utilities (for example, PIP) will not 
execute correctly. 


If you select DBMS-11 or communications products support, SYSGEN 
automatically includes the Get Partition Parameters, Get Task 
Parameters, and Extend Task directives. 


If you selected the Queue Manager for your target system, SYSGEN 
automatically includes support for the parent/offspring tasking 
directive. 


If you select ANSI magnetic tape support, error logging support, 
DBMS-11, the Queue Manager (QMG), the CO driver, communications 
products support, or the LA: (LPA11-K), SYSGEN automatically includes 
Send/Receive directive support. 


If you select any K-series devices, Connect to Interrupt Vector 
Support is included. ; 


Parent/offspring tasking with chaining is a superset of 
parent/foffspring tasking. If you select DBMS-11, the Queue Manager, 
or either parent/offspring tasking or parent/offspring tasking with 
chaining, SYSGEN automatically includes support for the stop-bit 
directives. 


If you select the Extend Task directive, SYSGEN automatically includes 
checkpointing support. This does not apply if you are generating an 
RSX-11S system. 


If you select the Specify Requested Exit AST directive, SYSGEN 
automatically includes AST support. 


If the target processor does not have a switch register, SYSGEN does 
not allow the inclusion of the Get Sense Switch directive. 
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* 38. Number of pre-allocated QIO packets [D R:0.-15. D:5.]: 


You can enhance I/O throughput by preallocating a number of I/0 
packets from the dynamic storage region and by leaving them available 
for quick use by Queue I/O. 


The Executive maintains a Last-In-First-Out (LIFO) list of 
preallocated I/0 packets. Specify the maximum size of this list with 
your decimal response to this question. When an I/O packet is 
required, the Executive removes one from this list. If the list is 
empty, the Executive allocates the packet from dynamic memory (a 
significantly slower operation). When an I/O packet is deallocated, 
the packet is linked back into the list, provided that the list is not 
full. 


Thus, in each I/O request, two fast LIFO operations replace the slower 
general pool allocations and deallocations, saving several hundred 
microseconds. Some I/O requests involving an ACP require two I/0 
packets and, therefore, benefit twice as much. 


Each I/O packet you preallocate requires 18 words from pool. To make 
the best use of this option, determine the average number of 
outstanding concurrent 1/0 Pedueete on your system and enter that 
value as your response. 


Enter a number in the range 0 through 15(10), indicating the number of 
packets to be preallocated. 


The default is 5. When your system uses preallocated QIO packets 
(that is, when you specify any value greater than zero), it takes 
advantage of QIO speed optimization. 


Enter 0 to exclude preallocated QIO packets as well as QIO speed 
optimization. 


* 39. Size of data transfer vector in words [D R:0.-33. D:33]: 


The value you supply in response to this question specifies the size 
in words of the data transfer vector. The data transfer vector is a 
series of MOV instructions in a loop used by the Executive for 
optimizing data transfers in the Executive routine SBLXIO which is 
then used by the Shuffler. The greater the size of the data transfer 
vector, the faster the Executive transfers the data in SBLXIO. The 
trade-off is speed for pool size. The smaller the data transfer 
vector, the greater the pool size. 


Enter a number in the range 0 through 33(10) to specify the number of 
MOV instructions in the vector. If the size of the data transfer 
vector were 16, for example, a 36-word data transfer enters the loop 
control only 3 times rather than 36 times if there were only one MOV 
instruction in the vector. 


‘The default vector size is 33(10). It is generally advisable to 
select this default. 
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If you specify a data transfer vector size that is greater than 0 but 
less than 5, SYSGEN forces that value to 5. The reason for this is 
that the data transfer vector is not really efficient until the number 
of MOV instructions in the loop is at least 5. However, you may 
specify a 0. In this case, SYSGEN builds the data transfer vector 
with a single MOV instruction in the loop. 


This option does not apply to unmapped systems. 
* 40. Round-robin scheduling interval in ticks [D R:0.-1000. D:5]: 


When many competing memory-resident tasks have equal priority, the 
Executive tends to give CPU time to tasks that appear first in the 
Active Task List (ATL). Entries in the ATL with equal priority 
normally appear in the order in which the tasks were installed. 


With the round-robin scheduling option, the Executive periodically 
rotates (when the specified number of ticks elapses) tasks of equal 
priority within the Active Task List, so that tasks of equal priority 
share CPU time. 


Round-robin scheduling refers to the algorithm whereby each task of a 
group of tasks is successively given preference for available 
processor time. The actual algorithm in RSX-11M is used to locate the 
first task within each priority class that is not blocked from 
executing, give it processor time, and, when it completes, move that 
task to the end of its respective priority class. Tasks that are 
mainly intended for computation, with a minimal amount of I/0, execute 
in a round-robin fashion. I/0-bound tasks tend to remain at the front 
of their respective priority class. 


Round-robin scheduling does not affect the normal competition for CPU 
time by tasks with different priorities. It also does not affect 
tasks not in the range set by the response to Questions 41 and 42. 
Round-robin scheduling affects only those tasks in the ATL (in memory) 
that are not blocked, checkpointed, or in a partition wait queue. 


Round-robin scheduling requires little Executive overhead (time and 
size). 


If you want this option, enter a number in the range 1 through 
1000(10). SYSGEN then asks Questions 41 and 42. 


Enter 0 if you do not want this option. 


The default is 5. 


NOTE 
The tick interval value can be changed after SYSGEN by 
using the VMR or MCR SET /RNDC command. 


* 41. Highest priority class for consideration [D R:1.-249. D:150.]: 


Round-robin scheduling affects a specified range of priority classes. 
A typical range is 1 through 150(10). The permissible range is 1 
through 250(10). 


DETAILS OF SYSGEN PHASE I 


EXECUTIVE OPTIONS (Cont.) 


This entry provides the highest priority class eligible for 
round-robin scheduling. The default is 150(10). 


This question appears only if you selected the round-robin scheduling 
option. 


NOTE 


The highest priority class value can be changed after 
SYSGEN by using the VMR or MCR SET /RNDH command. 


* 42. Lowest priority class for consideration [D R:1l.~-x. D:l.]: 


This is the lowest priority class eligible for round-robin scheduling. 


The permissible range is 1 through x(10), where x is equal to _ the 
highest priority class entered in response to Question 41. The 
default is l. 


This question appears only if you select the round-robin scheduling 
option. 


NOTE 


The lowest priority class value can be changed after 
SYSGEN by using the VMR or MCR SET /RNDL command. 


* 43. Executive level disk swapping interval [D R:0-5000. D:y]: 


Disk swapping is an Executive feature that varies the priority of 
memory-resident tasks with the same priority so that those tasks can 
share the use of memory resources. The feature swaps tasks to disk by 
using the swapping algorithm. 


The swapping algorithm creates an "effective" task priority by using 
the swapping interval (the response to this question) and the swapping 
priority (the response to Question 44). The swapping interval 
specifies a time parameter, within which the Executive scans the 
partition list and modifies the effective priority of a resident task. 
The swapping priority is an absolute numeric value that specifies the 
range through which the Executive varies a task's priority. (The 
range is negative swapping priority through positive swapping 
priority.) 


The Executive uses a byte in the task header to maintain the swapping 
priority: symbol SSSWPR in RSXMC.MAC. The symbol SSSWPR is equated 
to the swapping priority specified in Question 44. 


Each time a task is read into memory, the Executive initializes the 
Swapping priority in the task header to the value +SSSWPR (for 
example, +5 if you specify 5 as the swapping priority in Question 44). 
Then, when the swapping interval expires, the Executive decrements the 
Swapping priority of each memory-resident task by one until the _ task 
is checkpointed or until the swapping priority reaches the minimum 
value -SSSWPR (for example, -5). 


DETAILS OF SYSGEN PHASE I 


EXECUTIVE OPTIONS (Cont.) 


After decrementing the swapping priority of each task in the 
partition, the Executive determines whether or not an eligible task on 
disk can checkpoint a task in the partition. The Executive compares 
the running priority of the nonresident task with the effective 
priority of the resident task (effective priority is the sum of the 
running priority and the swapping priority). If the nonresident task 
can fit into the resident task's space and if, due to the decrementing 
of swapping priority, the priority of the nonresident task is higher, 
the nonresident task can checkpoint the resident task. 


Disk swapping applies to tasks competing for each main partition 
(except DEVICE and COMMON partitions) and for the highest priority, 
nonresident tasks assigned to those partitions. 


If you select this option, SYSGEN automatically includes support for 
checkpointing. 


The permissible range is 0 through 5000(10). The default (y) is a 
value that is equal to the round-robin scheduling interval multiplied 
by 6. The maximum default size is 5000(10). If the value of the 
default calculated for y exceeds 5000, SYSGEN defaults the value to 
the maximum size of 5000(10). If the round-robin scheduling interval 
was 0 (you excluded support), this default is 30(10). 


To disable this option, enter 0. 


NOTE 


The disk swapping interval can be changed after SYSGEN 
by using the VMR or MCR SET /SWPC command. 


This question does not appear for RSX-11S systems. 
* 44, Swapping priority [D R:1.-20. D:5.]: 


The swapping priority determines the range over which lower priority 
tasks may checkpoint higher ones. The larger the swapping priority, 
the greater the range. With a swapping priority of "S," a_ task 
running at priority "P" will have an effective priority range (for 
checkpointing) from "P+S" to "P-S" as long as it resides in memory. 


You can enter a number in the range i through 20(10). It is 
recommended that you enter the default swapping priority of 5. 


This question appears only if you selected Executive-level disk 
Swapping. 
NOTE 


The swapping priority can be changed after SYSGEN by 
using the VMR or MCR SET /SWPR command. 
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* 45. Size of Dynamic Storage Region (Pool) in words [D R:256.-16384. D:1024.]: 


Rather than allocate a fixed amount of memory for each function, the 
RSX-11M Executive makes use of a dynamically allocated memory space 
called the dynamic storage region (DSR), generally referred to as pool 
space. For example, the Executive uses this memory space to process 
I/O or time-dependent scheduling requests. As demands for space are 
made, the Executive allocates the necessary memory from pool using a 
first-fit algorithm. When allocated space is no longer needed, it is 
released back to the pool of available memory. 


Pool requirements for a system depend on the configuration, 
application, and degree of system loading. Enough memory must be 
available to satisfy peak demands. Otherwise, a. decrease in system 
performance occurs and the system could hang with a pool deadlock. On 
the other hand, if there is an unnecessarily large amount of pool 
space allocated, you may be wasting system resources (memory). 


The maximum size of pool space is limited by physical memory in an 
unmapped system. 


Appendix D specifies some RSX-11M functions that use dynamic memory. 
Use it to calculate how much memory you should allocate. 


After you calculate the amount of pool space needed _ for your target 
system, add approximately 12% to 18% to cover possible pool 
fragmentation conditions. 


Note that you can later extend this initial allocation using the MCR 
or VMR SET /POOL command. 


This entry must be in multiples of two words. The permissible range 
of entries is 256(10) through 16384(10). 


This question appears for unmapped systems only. (SYSGEN forces a 
minimum pool size of 1024(10) words for mapped systems and expands the 
pool size to the maximum size possible during the System VMR Section 
of Phase II. See the SET /POOL command in Chapter 10 of the 
RSX-11M/M-PLUS System Management Guide.) 


The default is 1024(10). 


* 46. Seconds between printer not ready messages [D R:0.-255. D:30.]: 


SYSGEN asks this question if you included a line printer in the 
peripheral configuration and if you included TKTN support (the TKTN 
task prints the "Device not ready" message). 


Specify the number of seconds between printer-not-ready messages. -An 
entry of 0 suppresses the messages altogether. 


The default is 30(10). If you specify a value other than 0, the 
minimum value of this entry is 15(10). 
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* 47. Seconds between card reader not ready messages [D R:0.-255. D:30.]: 


This question appears if you included a card reader in the peripheral 
configuration and if you included TKTN support (the TKTN task prints 
the “Device not ready" message). 


Specify the number of seconds between "Card reader not ready" 
messages. An entry of 0 Suppresses the messages altogether. 


The default is 30(10). 


If you enter a nonzero value, the minimum value of the entry is 
15 (10). 


* 48. System crash register and stack dump device CSR [O R:0-177700 D:177564]j 


If the system crashes and this option is included, the Executive stack 
and registers are output to the selected device. 


Enter the CSR address of the device. The normal device is the console 
terminal, which has a CSR address of 177564. This is the default 
device. 


Enter 0 to suppress this option. 


If you specify a value other than 0, it can only be in the range 
160000 through 177700(8). 


* 49. Checkpointing [Y/N]: 


Checkpointing allows the Executive to displace tasks from a partition 
to yield memory to tasks of higher priority. 


The goal of checkpointing is to avoid preempting the execution of 
lower priority tasks unless a higher priority task can make use of the 
memory resources allocated to the lower priority task. Checkpointing 
optimizes the use of processor memory while maintaining a 
priority-scheduling algorithm. 


In some cases, an activated task cannot execute because the partition 
where the task must execute is occupied. If the partition is occupied 
by a task (TASKA, for example) that is both checkpointable and has a 
priority lower than the task that is waiting (TASKB, for example), the 
Executive moves the task with the lower priority (TASKA) to disk, thus 
making room for the higher priority task (TASKB) waiting on disk. 
When the higher priority task (TASKB) is stopped or its priority is 
lowered, the lower priority task (TASKA) on disk moves back into 
memory to continue execution. This task (TASKA) continues execution 
from the point at which it was interrupted. 


RSX-11M supports checkpointing in both user-controlled partitions and 
system-controlled partitions. 
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” 


Respond Yes if you want checkpointing. Electing this option and 
answering No to Question 50 requires that you build each 
checkpointable task with its own contiguous checkpoint space, into 
which the executing task image can be swapped. Refer to the 
RSX-11M/M-PLUS and Micro/RSX Task Builder Manual, particularly to the 


information on using the /AL (allocate) switch. (SYSGEN automatically 
includes checkpointing if you selected Executive level disk swapping.) 


Note that if you exclude checkpointing support, the Executive cannot 
support task checkpointing during terminal input. 


If you select checkpointing, SYSGEN includes support for nonresident 
tasks (see Question 4). SYSGEN automatically includes checkpointing 
if you select Executive level disk swapping (Question 43), support for 
error logging (Question 24), or the Extend Task directive (Question 
37). 


This question appears for RSX-11S systems only if you chose DECnet 
Support (Question 32, Executive Options). 


* 50. Checkpointing with system checkpoint file [Y/N]: 


Respond Yes if you want checkpointing with a system checkpoint file. 
This option allows checkpointing with a system checkpoint file rather 
than requiring contiguous checkpoint space for each checkpointable 
task image. 


If you select checkpointing with a system checkpoint file, you must 
allocate space for the file when you start up the system, for example, 
in the STARTUP.CMD file. There is an ACS command included in the 
STARTUP.CMD file provided with your distribution kit. Refer to the 
ACS command in the RSX-11M/M-PLUS MCR Operations Manual for more 
information. a 


If you select multiuser protection (Question 12), SYSGEN automatically 
includes support for checkpointing with the system checkpoint file. 


This question appears only if you answer Yes to checkpointing 
(Question 49) and if you are generating a mapped target system. 


This question does not appear for RSX-11S systems. 


* 51. Crash dump analysis: A- PANIC B- Crash Dump Analysis (CDA) C- None [D: B] 


If you do not select the dump analysis option and a system failure 
occurs, it may not be possible for you to capture vital data on the 
state of the system at failure time. The RSX-11M Guide to Writing an 
I/O Driver describes the PANIC dump routine. The RSX-1IM/M-PLUS and 
Micro/RSX Crash Dump Analyzer Reference Manual describes CDA in 
detail. The CDA crash dump routine is normally used for debugging new 
drivers or privileged tasks after the drivers or tasks crash the 
system. CDA provides a means of generating a formatted dump of memory 
on a line printer or a terminal. 


Enter A if you want the PANIC dump routine. 
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Enter B (the default) if you want Crash Dump Analyzer (CDA) support. 
It is recommended that you select CDA support. 


If you select A, SYSGEN does not ask Questions 52, 53, and 54, but 
does ask Question 55. 


If you select B, SYSGEN asks Questions 52, 53, and 54, but not 55. 
* 52. CDA output notification device CSR [O R:160000-177700 D:177564]: 


This question appears only if you selected B (Crash Dump Analyzer 
support) in Question 5l. 


Enter the CSR for the device that you want the system crash message 
sent to. Typically, this is the console device (177564(8)). 


* 53. Enter CDA memory dump device mnemonic (ddu:) [S R:3-4]: 


This question appears only if you selected B (Crash Dump Analyzer 
support) in Question 51. 


Enter the mnemonic and unit number of the device on which you want’ to 
output a memory dump in binary. Note that the memory dump device must 
be part of the target hardware configuration but is not necessarily 
generated into the target system. Supported devices are: 


DB DM DY DU (RA60, RX50, RC25-removable) 
DD DR MM MU 

DK DT MS 

DL DX MT 


If you choose a device that is not on the first controller of a 
multiple-controller disk, you must specify the physical unit number of 
the device rather than the logical device unit number. When’ the 
system crashes, the notification message also uses the physical unit 
number of the device. 


NOTE 


If you choose DU as the crash dump device, SYSGEN will 
issue a warning that you cannot crash to a fixed-media 
disk (the RA80/RA81, the RD51/RD52/RD53, and _ the 
fixed-disk portion of the RC25). 


If possible, avoid using your system device as the crash dump device 
because CDA overwrites the contents of the crash dump device. 
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* 54. Enter CDA memory dump device CSR [O R:160000-177700 D:174500]: 


This question appears only if you selected B (Crash Dump Analyzer 
Support) in Question 5l. 


Enter the CSR address of the memory dump device. The default depends 
on the type of device you specify in Question 52 as the crash dump 
device: 


Device Default Device Default 
Type CSR Type CSR 

DB 176700 DU 172510 
DD 176500 DX 177170 
DK 177404 DY 177170 
DL 174400 MM 172440 
DM 177440 MS 172522 
DR 176700 MT 172522 
DT 177342 MU 174500 


The allowable DU:-type dump devices are the RA60, the RxX50, and the 
removable-disk portion of the RC25. 


* 55. Enter PANIC memory dump device CSR [O R:160000-177700 D:177564]: 


If you selected PANIC dump rather than CDA, enter the CSR address of 
the PANIC dump device. Normally, this is the CSR address of the 
console device, which is also the default. 


This device must be a paper tape-, terminal-, or line 
printer-compatible device. The device must receive a single byte at a 
time. 


* 56. RT-11 emulation support? [Y/N]: 


This option allows you to include RTEM support. Refer to your RTEM-11 
documentation for details. 
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4.6 TERMINAL DRIVER OPTIONS SECTION 

Your responses to these questions specify the RSX-11M terminal driver 
that you want as part of your target system. You can also specify 
terminal driver options. 

Terminal driver options are described fully in the RSX-11M/M-PLUS I/0 
Drivers Reference Manual. 


* 1. Terminal driver desired (A/B/C/D, * prints table) 


This option allows you to select the terminal driver you want to 
include in your. system. RSX-11M systems use one of two terminal 
drivers: 
e Half-duplex (three different versions) 
e Full-duplex 
Enter A to select the half-duplex terminal driver that allows you to 
specify the half-duplex terminal driver options that meet the needs of 
your target system. 
Enter B to select the user-oriented half-duplex terminal driver. 
SYSGEN automatically includes the following terminal driver options 
when you select the user-oriented terminal driver: 
@® Automatic carriage return/line feed (Question 4) 
e Task checkpointable during terminal input (Question 5) 
Note that this option requires Executive support for 
checkpointing; therefore, if you did not include checkpointing 
support, this option is excluded when you select the 
user-oriented terminal driver 
@e Unsolicited input character AST (Question 6) 
Note that this option requires Executive AST support; 
therefore, if you did not include Executive AST support, this 
option is excluded for the user-oriented terminal driver. 
e Write with CTRL/O cancellation (Question 7) 
e Break-through write (Question 8) 
e CTRL/R (retype) (Question 9) 
e Get multiple characteristics (Question 11) 
@e Get terminal driver options (Question 13) 
e Transparent read/write (Question 15) 


e Settable case conversion for input (Question 16) 


@e Read after prompt (Question 17) 
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e Read with no echo (Question 18) 

@ Read with Speeted terminator (Question 19) 
e CRT rubout support (Question 20) 

e Terminal/host synchronization (Question 21) 
e User terminal input buffering (Question 22) 


@e Variable-length terminal input buffering (Question 23) 


NOTE 
If you want more or fewer options than what is 
automatically included with the user-oriented 


half-duplex terminal driver, you should select’ the 
tailorable half-duplex terminal driver (enter A). 


Enter C to select the full-duplex terminal driver. This driver 
requires a mapped system and loadable driver support. SYSGEN 
automatically includes the following terminal driver options when you 
select the full-duplex terminal driver: 
e Passes form feeds directly to the terminal (Question 3) 
e Automatic carriage return/line feed (Question 4) 
e Task checkpointable during terminal input (Question 5) 
Note that this option requires Executive support for 
checkpointing; therefore, if you did not include checkpointing 
support, this option is excluded when you select the 
full-duplex terminal driver 
e Write with CTRL/O cancellation (Question 7) 
e Hold-screen mode (Question 14) 
e Transparent read/write (Question 15) 
e Settable case conversion for input (Question 16) 
@e Read with no echo (Question 18) 
@e Read with special terminator (Question 19) 
e Terminal-host synchronization (Question 21) 
e User terminal input buffering (Question 22) 
@e Variable-length terminal input buffering (Question 23) 


@e LA30P support (Question 24) 


e Parity enable and sense support 
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e ANSI-standard escape sequences 

e ANSI-defined advanced editing functions 

e@e Loadable (soft) character fonts 

e Block mode 
If you include a DHV1l device in your system, SYSGEN automatically 
includes the full-duplex terminal driver and does not ask this 
question. 
If you have not chosen a mapped system and loadable driver support, 
you must exit. You should restart SYSGEN and choose the mapped system 
and the loadable driver support to include the DHV1l device. 
Enter D to select the baseline terminal driver. Note that this driver 
and a multiuser protection system are mutually exclusive. This 
terminal driver (D) is a half-duplex terminal driver with minimum 
functionality. It has no SYSGEN options. 


* 2. Unsolicited input timeout value in seconds [D R:0.-255. D:120.]: 


This option is available with the full-duplex terminal driver only 
(C} The question does not appear if you responded A, B, or D to 
Question l. 


The full-duplex driver discards unsolicited input upon the expiration 
of the seconds. Valid time-out range is 0 through 255(10) seconds. 


Enter 0 to inhibit the unsolicited input timeout feature for the 
full-duplex terminal driver. 


Press the RETURN key for the default timeout value of 120 seconds or 
specify the number of seconds (in the range 1 through 255 decimal) to 
wait to timeout on unsolicited terminal input. 


* 3. Pass form feeds directly to the terminal? [Y/N]: 


This option appears only if you responded A or B to Question 1 (the 
tailorable or user-oriented half-duplex terminal driver). 


The half-duplex driver normally converts a form feed into eight line 
feeds. Respond Yes to suppress this conversion. 
NOTE 
If your system includes an LA120 or an LA180S 


terminal, you should respond Yes. 


This option adds approximately 24(10) words to the terminal driver. 
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* 4. Automatic carriage return/line feed? [Y/N]: 


This option appears only if you responded A to Question 1 (the 
tailorable half-duplex terminal driver). The user-oriented driver and 
the full-duplex driver include the option by default. 


If you respond Yes to this option (or if the option is included by 
default), the terminal driver generates a carriage return and line 
feed when the terminal buffer is filled on output or echo. (You can 
examine or alter terminal buffer size with the MCR SET /BUF command.) 


This option adds approximately 70(10) words to the terminal driver. 
* 5. Task checkpointable during terminal input? [Y/N]: 


The option appears only if you responded A to Question 1 and _ you 
included Executive support for checkpointing. 


If you select this option, checkpointable tasks can be displaced from 
memory by another task during terminal input. 


This option adds approximately 110(10) words to the terminal driver. 
If your target system does not include DECnet and if you did not 
select the full-duplex terminal driver, this option adds approximately 
160(10) words to the terminal driver. 


* 6. Unsolicited input character AST? [Y/N]: 


This option appears if you responded A or C to Question 1 and included 
Executive support for ASTs. The user-oriented and full-duplex drivers 
include this option by default if your target system includes 
Executive support for ASTs (Question 17 in the Executive Options 
Section). 


If you respond Yes, a task that attaches to a terminal can specify an 
AST entry point upon receiving unsolicited input from a terminal (for 
example, CTRL/C attaches the task rather than MCR). This option adds 
approximately 160(10) words to the full-duplex terminal driver and 
approximately 70(10) words to the half-duplex terminal driver. 


Without support for unsolicited input character AST, you cannot’ use 
EDT in character mode nor can you terminate RMD with a CTRL/Z. In 
addition, the I/O Exerciser (IOX) requires unsolicited input character 
AST support if it is to support the CTRL/C function. 


If you do not select this option and intend to use RMD, the RMD task 
displays only the first page of output. However, it is still 
possible, through other means, to read subsequent pages of the RMD 
display. See the RSX-11M/M-PLUS System Management Guide for an 
explanation. 


DETAILS OF SYSGEN PHASE I 


TERMINAL DRIVER OPTIONS (Cont.) 


* 7. Write with CTRL/O cancellation? [Y/N]: 


This question appears only if you responded A to Question l. 


If you respond Yes, a task that issues a write request with CTRL/O 
cancellation can print to the terminal when the target terminal has 
suppressed output with CTRL/O. This option adds approximately 16(10) 
words to the terminal driver. 


* 8. Breakthrough write? [Y/N]: 


This question appears if you responded A or C to Question l. If you 
selected multiuser protection support, SYSGEN automatically includes 
this option. 


If you respond Yes, a privileged task can issue a break-through write 
request that prints to a terminal regardless of current or outstanding 
I/O activity. 


This option adds approximately 96(10) words to the full-duplex 
terminal driver and approximately 245(10) words to the half-duplex 
terminal driver. 


NOTE 


When you select this option, SYSGEN automatically 
includes terminal driver support for the CTRL/R 
(retype) option (Question 9). Together, these two 
options add approximately 160(10) words to the 
full-duplex terminal driver and approximately 275(10) 
words to the half-duplex terminal driver. 


* 9. CTRL/R (retype)? [Y/N]: 

This question appears if you responded A or C to Question 1 and did 
not select the break-through write option (Question 8). 

If you respond Yes, the terminal driver sends to the terminal a 
carriage return and line feed followed by the contents of the input 
buffer whenever you type CTRL/R at the terminal. 

This option adds approximately 64(10) words to the full-duplex 
terminal driver and approximately 32(10) words to the half-duplex 
terminal driver. 

* 10. Escape sequence handling? [Y/N]: 

This question appears if you responded A or C to Question l. 

If you respond Yes, the terminal driver recognizes and treats escape 


sequences as line terminators for all solicited input except 
read-pass-all or read-with-special-—terminator requests. 
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This option adds approximately 128(10) words to the full-duplex 
terminal driver and approximately 160(10) words to the half-duplex 
terminal driver. 


* 11. Get multiple characteristics? [Y/N]: 
This question appears if you responded A or C to Question l. 


If you respond Yes, a task can determine physical characteristics (for 
example: CRT, VT52, slaved, or VT100) of individual terminals. The 
task RMD makes use of this option, for example. 


If you selected the full-duplex terminal driver (C) and want the 
capability to display terminal characteristics, you must include 
support for Get Multiple Characteristics. 


This option adds approximately 96(10) words to the full-duplex 
terminal driver and approximately 110(10) words to the half-duplex 
terminal driver. 

Under most circumstances, you should include this terminal driver 
option. 

* 12. Set multiple characteristics? [Y/N]: 

This question appears if you responded A or C to Question l. 

If you respond Yes, a task can set or reset physical characteristics 
(for example, CRT, VT52, slaved, or VT100) of its TI: terminal. A 


privileged task can _ use this option to set the physical 
characteristics of any terminal in the system. 


If you selected the full-duplex terminal driver (C) and want’ the 
capability to modify various terminal characteristics (see the MCR SET 
command), you must include support for Set Multiple Characteristics. 
This option adds approximately 256(10) words to the terminal driver. 
Under most circumstances, you should include this terminal driver 
option. 


* 13. Get terminal driver options? [Y/N]: 


This question appears if you responded A or C to Question l. 


If you respond Yes, a task can determine which of the terminal driver 
options were selected during system generation. 


This option adds approximately 32(10) words to the full-duplex 
terminal driver and approximately 64(10) words to the half-duplex 
terminal driver. 
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* 14. Hold-screen mode? [Y/N]: 

This question appears only if you responded A to Question l. 

If you respond Yes and your terminal(s) include special hardware, the 
terminals can break stream output into pages that fit on the screen. 


(Note that an unsolicited CTRL/C disables hold-screen mode.) 


This option adds approximately 92(10) words to the terminal driver. 


NOTE 
When you select this option, SYSGEN automatically 


includes terminal driver support for the transparent 
read/write option (Question 15). 


* 15. Transparent read/write? [Y/N]: 
This question appears only if you responded A to Question 1 and did 


not include the hold-screen option (Question 14). 


The terminal driver normally filters terminal input on both input = and 


output. This permits the recognition of control characters that have 
special meaning (for example, ESCAPE) or require fill characters (for 
example, RETURN). If you respond Yes, the terminal driver provides 


support for I/O functions (IO.RAL and IO.WAL) that bypass character 
filtering and permit output of up to 32K bytes. 


This option adds approximately 48(10) words to the terminal driver. 


* 16. Settable case conversion for input? [Y/N]: 


This question appears only if you responded A to Question I. 


The terminal driver normally accepts and echoes’ characters as 
received. 


If you respond Yes, you can selectively enable input character 
conversion (using the MCR SET /[NO]LOWER command) so that the terminal 
driver can automatically convert lowercase to uppercase. This option 
also allows the terminal driver to recognize the brace character (175) 
and the tilde character (176) as ASCII characters rather than a form 
of escape when the terminal is set to lowercase. 


This option adds approximately 30(10) words to the terminal driver. 


* 17. Read after prompt? [Y/N]: 


This question appears if you responded A or C to Question l. 


If you respond Yes, a read after a prompt request acts like a write to 
the terminal followed by a read. This reduces the overhead of one I/0 
request and eliminates context switching. Also, this option removes 
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the execution window (provided the terminal is not attached) by which 
one task can prompt and another task initiate terminal I/O before the 
first task (the prompting task) has time to issue its read request. 

This option adds approximately 128(10) words to the full-duplex 


terminal driver and approximately 185(10) words to the half-duplex 
terminal driver. 


* 18. Read with no echo? [Y/N]: 


This question appears only if you responded A to Question 1 and did 
not include multiuser protection support. (Multiuser protection 
Support automatically includes this terminal driver option.) 

If you select this option, you can issue the read functions I0O.RLB, 
IO.RVB, and I0.RPR, and specify that the driver not echo terminal 
input. 


This option adds approximately 48(10) words to the terminal driver. 
* 19. Read with special terminator? [Y/N]: 


This question appears only if you responded A to Question 1 and did 
not include multiuser protection support. (Multiuser protection 
support automatically includes this terminal driver option.) 

The line terminator for a normal read is the RETURN or ESCAPE. If you 
select this option, any character less than 40(8) or greater than 
174(8) can terminate a read with a special terminator request. 
However, escape sequences cannot be recognized in this mode. 


Note that if the terminal is set to lowercase, only 177(8) and 
characters less than 40(8) can act as terminators. 


This option adds approximately 45(10) words to the terminal driver. 
* 20. CRT rubout support? [Y/N]: 


This question appears if you responded A or C to Question l. 
If you respond Yes, the terminal driver erases a character on a CRT 
terminal screen when you press the RUBOUT or DELETE key. The driver 
echoes the rubouts or deletions as backspace-space-backspace. 


This option adds approximately 64(10) words to the terminal driver. 

* 21. Terminal-host synchronization? [Y/N]: 

This question appears if you responded A to Question l. 

If you respond Yes, you can start and stop terminal output by typing 


CTRL/S (to stop) and CTRL/Q (to start). This option is useful for 
high-speed display terminals. 
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This option adds approximately 84(10) words to the terminal driver. 


NOTE 


If your system includes a vT50 terminal with the 
copier option or an LA120 or VT100 with a baud rate 
greater than 1200, you must respond Yes to this 
question. 


* 22. User terminal input buffering? [Y/N]: 


This question appears only if you responded A to Question l. 


The terminal driver normally receives characters and stores’ the 
characters in the Executive address space until it receives a line 
terminator. Upon receiving a line terminator, the driver places’ the 
contents of the Executive address space into the requesting task's 
input buffer. 


If you respond Yes, the driver, provided that the task is not 
checkpointable, places the input characters directly into the task 
buffer as the characters are received. 


This option adds approximately 12(10) words to the terminal driver. 
* 23. Variable length terminal input buffering? [Y/N]: 


This question appears only if you responded A to Question l. 

Normally, terminal driver input buffers are 80 bytes long, which 
implicitly limits the maximum size of a terminal input request as well 
as the size of the buffer allocation from dynamic memory. 

If you respond Yes, the terminal allocates buffers large enough to 
Satisfy the read request. The largest buffer can be 255(10) bytes 
long. 


This option adds approximately 24(10) words to the terminal driver. 
* 24. LA30P support? [Y/N]: 


This question appears only if you responded A to Question l. 


The LA30P DECwriter connects to the processor with a single buffered 
interface. Respond Yes only if your system includes an LA30P 
terminal. The terminal driver supports all other combinations of 
DIGITAL terminals and interfaces. 


If you respond No, the second of two rapidly typed characters may be 
discarded by the terminal driver. 


This option adds approximately 48(10) words to the terminal driver. 
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* 25. Hardware unrecoverable input error notification? [Y/N]: 


This question appears only if you responded C to Question l. 

If you respond Yes, the full-duplex terminal driver detects and flags 
framing errors, character parity errors, and data overruns, and then 
passes the input character(s) to the requesting task with notification 
of an input error (including type). 


If you respond No, the driver ignores hardware unrecoverable input 
errors. 


This option adds approximately 32(10) words to the terminal driver. 
* 26. Device independent cursor positioning? [Y/N]: 


This question appears only if you responded C to Question l. 


If you respond Yes, the full-duplex terminal driver supports 
terminal-independent cursor-positioning commands. When you specify a 
cursor-positioning character, the driver outputs a cursor-positioning 
character string before it outputs the buffer. 


This option adds approximately 192(10) words to the terminal driver. 
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4.7 SYSTEM OPTIONS SECTION 


This section presents several options that let you tailor your system 
further. Read the description of each option carefully before making 
your selections. 


* 1. Include ANSLIB.OLB to support big-buffering? [Y/N]: 


This option allows you to include ANSLIB.OLB, which contains’ the 
routines necessary to support big buffering for FCS. (If you need 
more information on big-buffering for FCS, see the RSX-11M/M-PLUS 1/0 
Operations Manual.) Sa ty, ee 


If you respond Yes, SYSGEN creates ANSLIB.OLB as it would have if you 
had chosen ANSI magnetic tape support in Question 13 of the Executive 
Options Section. 


* 2. Build library of ISA FORTRAN industrial/lab routines? [Y/N]: 


If you respond Yes to this question, SYSGEN builds the "Industrial 
Computer System FORTRAN Procedures for Executive Function and Process 
Input-Output (ISA SP61.1)" for the IC, IS, UD, AR, LA, or LS devices 
in the system library. These routines (commonly known as the Purdue 
calls) comprise an interface of FORTRAN subroutines that conform to a 
formal standard approved by the Instrument Society of America. The 
standard deals with three areas of real-time systems: the Executive 
interfaces, the process input-output function interfaces, and bit 
string manipulation. 


If you include only one of the previously named devices, SYSGEN puts 
the necessary routines in [1,1]SYSLIB.OLB of the privileged object 
disk (the baseline disk for the big-disk distribution kit and PRVBLD 
for the RLO1/02 distribution kit. 


However, if you specify more than one of those devices for your target 
system, SYSGEN builds individual libraries of routines for each 
device. Some routines for a device have the same name as _ some 
routines for another device. The different libraries are necessary to 
contain the different routines: 


Device Library 

AR/LS {[1,1]LPSLIB.OLB 
Ic [1,1] ICSLIB.OLB 
Is [1,1]ISLIB.OLB 
LA {1,1]LPALIB.OLB 
UD [1,1]UDCLIB.OLB 


If you did not specify one of these devices in Question 15 of the 
Target Configuration Section, this question does not appear. 
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* 2A. Include support for the IP11 Industrial I/O Subsystem? [Y/N]: 


The IP11 Industrial I/O Subsystem is a combined software and hardware 
package used for process control and monitoring in the industrial and 
manufacturing environment. The subsystem consists of an RSX device 
driver (IPDRV) anda set of FORTRAN-callable interface routines used 
to interface to a variety of hardware I/O modules, including digital 
sense interrupt, change-of-state, digital output, digital-to-analog 
converter, and analog-to-digital converter modules. 


Refer to the IPl1l Subsystem Software Installation Guide for 


re 


* 2B. Include support for IP11 powerfail? [Y/N]: 


The IP11 subsystem can optionally save the context of digital outputs 
and digital-to-analog converters upon system power fail and restore 
them when the power is restored. Answering Yes to this question 
causes the inclusion of the Executive support needed for this feature 
and adds approximately 40(8) bytes to the size of the Executive. This 
support must be taken in order to have power-fail support in the IP11 
driver itself. 


* 3. Build the PLAS resident FCS? [Y/N]: 


If you respond Yes, a copy of the FCS routines reside in a common area 
in memory (FCSRES). Tasks can then link to this resident library of 
FCS routines rather than contain a copy of the FCS routines in their 
task image. Tasks that use FCS and are linked to FCSRES are generally 
smaller than tasks containing their own FCS routines. Therefore, they 
task build faster, take up less disk space, and load faster. In 
addition, if you choose this option, SYSGEN optionally builds most 
utilities to link to FCSRES (the introductory text in Chapter 7 lists 
some of those utilities). If you select this option, SYSGEN task 
builds several privileged tasks during Phase II to link to FCSRES. 


Frequently, a highly overlaid task has FCS overlays. Linking to 
FCSRES means fewer overlays in this case. 


If you have selected ANSLIB.OLB (either by choosing ANSI magnetic tape 
support or by selecting ANSLIB for big buffering), Phase II of SYSGEN 
builds FCSRES using ANSLIB.OLB. 


If you are building a system with a relatively small amount of memory, 
you may not want this option. The 6K FCSRES remains in memory. 


This question appears only if you are generating a mapped RSX-11M 
system and only if you selected the option for memory management 
(PLAS) directives in Question 7 of the Executive Options Section 
earlier in Phase I. 


This question does not appear for RSX-11S systems or if you did not 
select FCP support in Question 2 of the Executive Options Section. 
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* 4. Code for FCP (A/B/C/D/E, * prints table) [D: <default>]: 


If you selected Files-1ll ACP (FCP) support in Question 2 of the 
Executive Options Section, SYSGEN displays this question to let you 
select the version of FCP best suited to your application needs_' and 
memory limits. 


You may select from five FCPs. The first four versions of FCP (A,B,C, 
and D) have the same functionality. However, the performance of each 
version differs greatly. Read the descriptions below carefully before 
making your selection. 


A. MINIMUM (FCPMIN) 


This version of FCP is not recommended for general use. It 
should be used only when size is critical. It runs in just over 
2K words of memory and is heavily overlaid. 


This version does not support buffer caching or other performance 
optimization features. Furthermore, it does not optimize 
directory operations. 


An application running stand-alone that opens large contiguous 
files and does no additional file I/0, except for reading and 
writing to those files, may get adequate performance using’ the 
MINIMUM FCP. 


The MINIMUM FCP is available on both mapped and unmapped RSX-11M 
systems. 


Enter a response of A to choose this version of FCP. 
B. SMALL (FCPSML) 


This version of FCP is heavily overlaid and supports’ limited 
performance optimization features. It runs in approximately 2.5K 
words of memory. 


The SMALL FCP requires from 10 to 100 times more I/O for’ such 
operations as looking for directories and opening files than the 
larger versions of FCP. However, for many applications, it 
provides satisfactory response. Using a larger version of FCP 
that results in more checkpointing or swapping may result in 
reduced performance even in a program development environment. 


The SMALL FCP is available on both mapped and unmapped RSX-11M 
systems. The SMALL FCP is the default FCP for unmapped RSX-11M 
systems. 


Enter a response of B to choose this version of FCP. 

C. MIDDLE (FCPMDL) 
Most ACP I/0 requests require only a few additional I/O 
operations with this version of FCP. The MIDDLE FCP generally 


provides the best performance without using undue amounts of 
memory. 
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The MIDDLE FCP provides buffering for caching of directories and 
the bitmap, which significantly increases performance in most 
cases. The MIDDLE FCP provides additional buffer space for about 
20 open files and accessed directories, and, therefore, minimizes 
the use of system pool. This FCP uses approximately 5K words of 
memory. 


The MIDDLE FCP is available only on mapped RSX-11M systems. The 
MIDDLE FCP is the default FCP for mapped RSX-11M systems. 


Enter a response of C to choose this FCP. 
D. LARGE (FCPLRG) 


This FCP provides the maximum performance. It has no overlays, 
thus it has no system overhead or I/O overhead for executing any 
code sequence. The LARGE FCP has the maximum number of buffers 
for all operations (such as creating, extending, and deleting 
files, and directory operations) as well as a large directory 


buffer. The large directory buffer maximizes performance with 
large directories. This version also provides additional buffer 
space for about 20 open files and accessed directories, 


minimizing the use of system pool. 
The LARGE FCP uses approximately 10K words of memory. 
The LARGE FCP is available only on mapped RSX-11M systems. 
Enter a response of D to choose this version of FLIACP. 
E. OTHER 


Enter a response of E to this question if you intend to supply 


your own FCP. The following are general guidelines for 
assembling, task building, and installing your FCP in the’ system 
image: 


e Following the completion of Phase I, assemble your FCP using 
{11,10]RSXMC.MAC (the Executive assembly prefix file created 
by SYSGEN) and [1,1]EXEMC.MLB (the Executive macro library) to 
produce FCP object file(s). 


e Task build your FCP in Phase II when SYSGEN pauses for that 
purpose, The FCP should be built using RSX11M.STB (the 
Executive symbol table file), which can be found in directory 
[1,54] for mapped systems and [1,50] for unmapped systems. 


e During Phase II, SYSGEN does not ask if you want to edit 
SYSVMR.CMD. Instead, it automatically pauses to allow you to 
edit SYSVMR.CMD. You must edit SYSVMR.CMD at that time to 
include the command to install your FCP in the system image. 


For systems with several high-performance disks, it is possible to 
increase file system throughput by mounting each volume with a 
separate FCP. Distinct FCPs allow a separate pool of FCBs (File 
Control Blocks) for each disk volume in each FCP partition and allow 
overlapping directory requests on each volume. 


The FCP default name algorithm of the MOUNT command. simplifies 


specifying separate FCPs (see the RSX-11M/M-PLUS MCR Operations 
Manual). 
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It is recommended that the file system FCP not share a_ user-partition 
with tasks that perform file-structured I/0, especially in systems 
with minimal user memory. The operation of RSX-11M is heavily 
dependent on the file system. Nearly all tasks request processing 
from it. Thus, for a system to operate properly, the file system must 
be ina partition where it can react promptly. Most tasks request an 
I/O operation through an FCP, and, while this I/O operation is in 
progress, the tasks cannot be _ checkpointed. Thus, if the FCP is 
running in the same partition, it may not be able to be loaded _ into 
memory to process the request and a deadlock situation can occur. 


* 5. Build Post Mortem Dump (PMD)? [Y/N]: 


This option lets you specify whether or not you want to have the Post- 
mortem Dump (PMD) task built during Phase II. The RSX-11M/M-PLUS and 
Micro/RSX Task Builder Manual describes the PMD task. 


This question does not appear for RSX-11S systems. 
* 6. Build the Resource Monitoring Display task (RMD)? [Y/N]: 


This option lets you specify whether or not you want RMD task built 
during Phase II. If you select this option and if you did not 
previously select support for asynchronous system traps (Question 17 
in the Executive Options Section), unsolicited terminal input 
character AST (Question 6 in the Terminal Driver Options Section), and 
Get Multiple Characteristics (Question 11 of the Terminal Driver 
Options Section), SYSGEN forces support for them at this time. 


See the RSX-11M/M-PLUS System Management Guide for details on RMD. 


This question does not appear for RSX-11S systems. 
* 7. Build the non-queue manager print spooler (PRT)? [Y/N]: 


If you did not select support for the Queue Manager in Question 35 of 
the Executive Options Section, this option allows you to build the 
serial despooler. See the RSX-11M/M-PLUS Batch and Queue Operations 
Manual for details on the non-Queue Manager print spooler. 


This question does not appear for RSX-11S systems. 
* 8. Do you want DIGITAL Command Language (DCL)? [Y/N]: 


DCL is an alternate CLI (command line interpreter) supplied by 
DIGITAL. It is a user-oriented command language. Refer to the 
RSX-11M Command Language Manual for further information on DCL. 
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If you have not previously included the following options in your 
target system, SYSGEN automatically includes them when you respond Yes 
to this question: 


@e Install, request, and remove on exit (Question 21 of the 
Executive Options Section) 


e Asynchronous system traps (Question 17 of the Executive 
Options Section) 


@e Get Task Parameters directive (Question 37 of the Executive 
Options Section) 


@e Parent/offspring tasking with Chaining (Question 37 of the 
Executive Options Section) 


@e The stop-bit directives (Question 37 of the Executive Options 
Section) 


e The Specify Requested Exit AST (Question 37 of the Executive 
Options Section) 


This option is not available for RSX-11S, unmapped systems, or RSX-11M 
systems without multiuser protection. 


* 9. Enter the number of user-written CLIs [D R:<0-MAX> D:0]: 


A CLI (command line interpreter) is a task that receives all 
unsolicited input from user terminals. The function of a CLI is to 
interpret and execute the unsolicited input as commands. The commands 
are predefined by the CLI. (MCR is the system CLI on RSX-11M.) 


If you select this option, SYSGEN provides you with the necessary 


Executive support for alternate CLIs. Refer to the RSX-11M/M-PLUS 


System Management Guide for details on writing a CLI. 


The maximum number of CLIS supported (in any combination) is 16(10). 
Therefore, the maximum number of user-written CLIS (<max>) is 16 minus 
the number of CLIs currently in the target system (where MCR, DCL, and 
DECnet are CLIS). 


MCR (the system CLI) is always present on RSX-11M_ systems. DECnet, 
though it is included as one of the possible CLIs, does not require 
alternate CLI support. DCL, an alternate CLI supplied by DIGITAL, 
does require alternate CLI support. If you select DCL as an option, 
SYSGEN automatically includes alternate CLI support. 


Alternate CLI support is not available for RSX-11S, unmapped systems, 
or RSX-11M systems without multiuser protection. 


* 10. Do you want pool monitoring and low pool recovery (PMT)? [Y/N] 


If you respond Yes to this question, SYSGEN includes the Pool Monitor 
Task (PMT) in your target system. PMT is a 1K- to 2K-word privileged 
task that runs at least once a minute to monitor pool fragmentation. 
In addition, this option includes code in the Executive that monitors 
the size of pool and notifies PMT whenever a significant change in the 
pool size occurs. 
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PMT enables checkpointing for itself whenever it detects a normal pool 
condition and disables checkpointing when pool is low or the largest 
pool fragment is smaller than the size of the CLI buffer. The latter 
guarantees that pool resources are always available for the PMT task 
to execute. 


Whenever either the Executive or PMT determines that pool resources 
are low, PMT issues a warning to logged-in terminals that pool is low 
and requests that users on the system exit from their active tasks. 
In addition, PMT displays specific information at the console terminal 
about the amount of free pool space and the size of the largest pool 
fragment. 


If PMT detects extreme pool fragmentation (that is, if the largest 
pool fragment is less than the size of the CLI command buffer), PMT 
also displays on the console terminal a list of abortable tasks in 
memory and requests that the system manager abort one or more of them. 


The SET /PLCTL command (described in the RSX-11M/M-PLUS MCR Operations 
Manual) allows you to control pool limit parameters. For more details 
on PMT, see the RSX-11M/M-PLUS System Management Guide. 

If you select this option and have not selected support for AST, 
Cancel Selective Marktimes, system-controlled partitions, and Specify 
Requested Exit AST (Questions 17, 18, 33, and 37 of the Executive 
Options Section), SYSGEN forces support for them at this time. 


This option is available only for mapped RSX-11M systems. 
* 11. What name would you like to give your system? [D: <default>]: 


This option allows you to assign a name to your system to distinguish 
it from other RSX-11M systems you may have. The following tasks all 
make use of the system name: 

BRO HEL RMD 

BYE PMT SHUTUP 


The name must be from one through six alphanumeric characters. A name 
with fewer than six characters is padded to the right with spaces. 


The default response for RSX-11M systems is RSX11M. 


The default response for RSX-11S systems is RSX11S. 
* 12. Do you want SPM-11 support [Y/N]: 


If you respond Yes, SYSGEN includes support for the Software 
Performance Monitor (SPM-11M) for RSX-11M systems. Refer to your 
SPM-11M documentation for details. 
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To include SPM-11M support, you must have the following hardware: 
@ Mapped system 


e Expansion space for the programmable clock provided with the 
SPM-11M package 


@e Extended Instruction Set (EIS) 


If you have not previously included the following options in your 
target system, SYSGEN automatically includes them when you respond Yes 
to this question: 


e Asynchronous system traps (Question 17, Executive Options 
Section) 


e The Get Task Parameters directive (Question 37, Executive 
Options Section) 


e The Extend Task directive (Question 37, Executive Options 
Section) 


e The Get Partition Parameters directive (Question 37, Executive 
Options Section) 


e The Send/Receive directive (Question 37, Executive Options 
Section) 


@e Checkpointing to a system checkpoint file (Question 50, 
Executive Options Section) 


It is recommended that you have memory management (PLAS) support 
(Question 7 of the Executive Options Section) for SPM-11M. Without 
PLAS support, SPM-11M buffering is limited to 4K words, and overflows 
may occur during data collection resulting in a loss of data. With 
PLAS support, SPM-11M buffers can be allocated up to 32K words. 


However, if you choose not to include PLAS support, but you still want 
SPM-11M support, the following message will appear: 


Because PLAS was. not included, 
the Data Collection (COL) task's buffer will 
be limited to 4K word static common. 


This question does not appear for RSX-11S systems, unmapped systems, 
or systems without EIS support. 
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4.8 PERIPHERAL OPTIONS SECTION 


This section of questions describes the peripheral devices. To make 
references to specific device questions easier, the questions in this 
section are listed by the device mnemonic in alphabetical order rather 
than by question numbers. Your responses to the questions define 
unique hardware and software information that RSX-11M uses to 
communicate with peripheral devices. SYSGEN generates questions only 
for those devices you specified in response to Question 15 of the 
Target Configuration Section. 


Enter the device-dependent parameters that define addressing 
information as well as special attributes for the peripheral devices. 
SYSGEN displays a prompt line describing the required parameters and 
then a specific device question, which includes any default values for 
the parameters. (See Example 4-1 at the end of this chapter for 
typical SYSGEN prompts and questions for the Peripheral Options 
Section.) 


For example, if you selected loadable driver support, the general form 
of a SYSGEN prompt is: 


* Enter [L/R,] parameterl, parameter2,...parametern for: 


Possible entries are defined as: 


L/R An optional parameter that specifies whether the driver is 
loadable (L) or resident (R). Note that you specified the 
default value for this parameter in your response _ to 
Questions 15 and 16 of the Executive Options Section. To 
have loadable driver support, you must answer Yes to 
Executive Options Question 15. The default for loadable or 
resident drivers (in the Peripheral Options Questions) is 
based on your response to Question 16 in the Executive 
Options Section. If you do not, however, select loadable 
driver support (that is, if you answer No to Question 15 in 
the Executive Options Section), all drivers for your target 
system are resident and you cannot override that default in 
this section. 


The process control drivers (UDC, ICS/ICR, and DRS/DSS 
drivers) and the VT11/VS60 graphics driver are not 
loadable. This parameter does not appear for these drivers 
because they are always resident. 


The full-duplex terminal driver is always loadable. This 
parameter does not appear for the full-duplex terminal 
driver. 


If you override the default (specify an L or an R), you 
must terminate this parameter with a comma (,), even if it 
is the only parameter on the line. 


parameter A device-dependent parameter such as CSR or vector address. 
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If you did not select loadable driver support, the general form of a 
SYSGEN prompt is: 


Enter parameterl, parameter2,...parametern for: 
where parameters 1, 2, and n are device-dependent parameters. 


In the SYSGEN prompts, parameters enclosed in brackets ([]) are 
permitted only in the response for the first controller. Parameters 
enclosed in parentheses (()) are required only if the indicated option 
is present in the target system. 


Some devices require common parameters. To display the specific 
device question, SYSGEN groups the devices that require common 
parameters together and then presents them on the same SYSGEN prompt 
line. 


The device-specific questions display default values for the 
parameters listed in the SYSGEN prompt line. When the question does 
not display a parameter, you must enter a parameter value. A comma 
(,) is the parameter delimiter. Note that blanks or tabs are not 
permitted between parameters. 


When you specify a required parameter or override the default value, 
SYSGEN checks the acceptable range for each parameter. If the value 
you enter is not within the acceptable range, SYSGEN issues an error 
message that identifies the parameter by number, according to its 
position in the prompt line. Note that if your system includes 
loadable driver support, the optional L/R parameter is not included in 
the parameter count. For example, if you enter 300 as the CSR address 
for a CR11 controller SYSGEN displays: 


SGN -- Parameter ( 2) "300" out of range 160000 to 177700 -- RETRY 


and then repeats the question. The number in parentheses is’ the 
parameter count (excluding L/R if applicable) and the value in quotes 
is the invalid parameter. 


CAUTION 


When you enter a numeric value, do not include a 
period (to specify a decimal number) or a pound sign 
(to specify an octal number). This causes an error. 
SYSGEN attempts to validate your response and does not 
permit explicit decimal or octal entries. 


Enter numeric values within the acceptable range. 
SYSGEN interprets the response to be octal or decimal 
as required. 


Refer to the description accompanying each question if 
you are unsure of the base for a specific numeric 
response. 


The following is a detailed description of all the peripheral 
questions. All CSR and vector addresses are octal values. All other 
values to be input are appropriately defined as octal or decimal. 
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* AD controller 0 [D:176770] 


Enter the CSR address (the default value is 176770) and the number of 
A/D channels (there is no default for this parameter) for the first 
ADO1-D controller. 


The ADO1-D analog-to-digital converter is a noninterrupt device. 
Therefore, you do not enter an interrupt vector address. 


The acceptable range for the number of A/D channels is 1 through 
64(10). 


If you do not enter the default value for the CSR address, the 
acceptable range is 160000 through 177700. 


There is no default CSR address for subsequent ADO1-D controllers. 
You must enter a value within the acceptable range. 


* AF controller 0 [D:134,172570] 


Enter the interrupt vector address (the default value is 134), the CSR 
address (the default value is 172570), and the number of A/D channels 
(there is no default for this parameter) for the first AFCI1I1 
controller. 


The acceptable range for the number of A/D channels is 1 through 
1024(10). 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR address for subsequent AFC1l controllers. You 
must enter a value, within the acceptable range, for the vector and 
CSR addresses as well as the number of A/D channels. 


* AR controller 0 [D:,170400,,,,,170420] 


The clock vector address for the AR11l controller is assigned from the 
floating vector space starting at location 300(8). It is located at 
an offset of four from the beginning of the AR11]1 vector space. Thus, 
there is no default clock vector address for the AR11. 


Enter a clock vector address between 300 and 774(8). Consult your 
DIGITAL Field Service representative if the clock vector address is 
unknown. 


The standard CSR address for the AR11 is 170400. Specify the address 
of the first word of the AR11 CSR group (the default value is 170400). 
If you do not enter the default CSR address, the acceptable range is 
160000 through 177700. 
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The polarity mask word specifies whether an individual channel is 
unipolar or bipolar; it corresponds one-to-one with the 16 possible 
channels. A 11-bit designates a unipolar channel and a O-bit 
designates a bi-polar channel. The acceptable range for the polarity 
mask word is 0 through 177777(8) (0 specifies 16 bi-polar channels, 
177777 specifies 16 unipolar channels). 


The AR11 module includes a D/A converter. However, support for the 
D/A is optional in the driver. If you do not include D/A support, 
enter NO for parameter 4. The driver will be significantly smaller. 


The maximum number of samples must be evenly divisible into 10,000 and 
within the acceptable range of 1 through 2500(10). 


The AR11 does not include the 16-bit digital I/0 option that is 
available with the LPS1l. However, you can achieve the same 
functionality by using the DR11-K. If the DR11-K is present, enter 
DRK in your response string just prior to the CSR address of the 
DR11-K; otherwise, enter NO as the last parameter in your response. 
The DR11-K must be jumper selected to use the 16 individual input 
lines without interrupts. If the DR11-K option is present, enter the 
CSR address of the DRI1-K (the default value is 170420). If you do 
not enter the default DR11-K CSR address, the acceptable range is 
160000 through 177700. 


Subsequent AR11 controllers default only the CSR address of the DR11-K 
option. You must enter the other values within the acceptable ranges. 
Also, if subsequent AR11 controllers do not include the DR11-K option, 
you must exclude this parameter. 


* CR controller 0 [D:230,177160] 


Enter the interrupt vector address (the default value is 230) and the 
CSR address (the default value is 177160) for the first CR11 card 
reader controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR or vector address for subsequent CR11 
controllers. You must enter values within the acceptable ranges. 


* CT controller 0 [D:260,177500] 


Enter the interrupt vector address (the default value is 260) and the 
CSR address (the default value is 177500) for the first TA11 cassette 
controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR or vector address for subsequent TA11 
controllers. You must enter values within the acceptable ranges. 
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* DB controller 0 [D:254,176700,,0,0] 


Enter the interrupt vector address (the default is 254), the CSR 
address (the default is 176700), the number of RPO04/RP05/RP06 drives 
(there is no default for this parameter), the unit number of the first 
drive (the default for the first physical unit number is 0), and 
whether or not the controller supports offset recovery (the default is 
O, for offset recovery) for the first RH11 or RH70 controller. 


Offset recovery support provides a higher degree of data integrity in 
environments where disk packs are frequently moved from drive to 
drive. This support moves the disk head on either side of the 
cylinder center line in an attempt to pick up a stronger signal. 
Thus, offset recovery support allows data to be read in instances 
where it could not otherwise be read. 


If you use the default values (enter two commas (,,) followed by the 
number of drives), the acceptable range for the number of drives is 1 
through 8(10). 


If you do not use the default values, the acceptable ranges are: 


Vector 60 through 774 (8) 

CSR .160000 through 177700 (8) 
Number of drives 1 through 8(10) 

Unit number of first drive 0 through 7(10) 

Offset recovery O or NO 


Subsequent RH11 or RH70 controllers default only the unit number of 
the first drive (0). 


NOTE 


You can specify offset recovery support only for’ the 
first DB controller. If you include support for the 
first controller, you automatically include offset 
recovery support for subsequent controllers. 
Likewise, if you exclude support, you exclude offset 
recovery support for subsequent controllers. 


After you enter the parameters for each RH11 or RH70 controller 
included in your system, SYSGEN immediately prompts for the drive 


type. 
* DB Contr 0 unit 0 is an RPO4/RPO5/RPO6 [D:RP06] 


This question immediately follows parameter specification for each DB 
controller. You must specify the type of drive. Enter RP04, RPO5, or 
RPO06 (the default response). 


SYSGEN repeats this question for each device unit specified for each 
controller. 
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* DD controller 0 [D:300,176500] 


Enter the interrupt vector address (the default value is 300), the CSR 
address (the default value is 176500), and the number of DECtape II 
drives (there is no default for this parameter) for the first TU58 
controller. 


The acceptable range for the number of DECtape II drives is 1 through 
2(10). 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR or vector address for subsequent TU58 
controllers. You must enter values, within the acceptable ranges, for 
the vector and CSR assignments as well as the number of drives. 


* DF controller 0 [D:204,177460] 


Enter the interrupt vector address (the default value is 204) and the 
CSR address (the default value is 177460) for the first RF11 
controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR or vector address for subsequent RF11l 
controllers. You must enter values within the acceptable ranges. 


* DK controller 0 [D:220,177404] 


Enter the interrupt vector address (the default value is 220), the CSR 
address (the default value is 177404), and the number of RKO5 drives 
(there is no-default value for this parameter) for the first RK11l 
controller. 


The CSR for the DK device is not the first register in the DK register 
set. The default CSR address displayed with this question is the 
actual CSR address for this device. 


The acceptable range for the number of RKO5 drives is 1 through 8(10). 


NOTE 


An RKO5SF is a fixed-media RKO5 drive equivalent to two 
removable RKO5 drives. Specify every RKO5F as two 
RKO5s. 


If you do not enter the default vector and CSR assignments, the 
acceptable range is 60 through 774 for the vector and 160000 through 
177700 for the CSR. 
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* DL controller 0 [D:160,174400] 


Enter the interrupt vector address (the default value is 160), the CSR 
address (the default value is 174400), and the number of RLO1/RLO2 
disk drives (there is no default for this parameter) for the first 
RL11/RLV11 (for RLO1S) or RL21/RLV21/RLV12 (for RLO2s) controller. 


The acceptable range for the number of RLO1/RLO2 disk drives is 1 
through 4(10). 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR or vector address for subsequent RL11/RLV11 or 
RL21/RLV21/RLV12 controllers. You must enter values, within the 
acceptable ranges, for the vector and CSR assignments as well as the 
number of RLO1/RLO2 drives. 


* DL Contr 0 unit 0. is an RLO1/RLO2 [D:RLO1] 


This question immediately follows parameter specification for each DL 
controller. You must specify the type of drive. Enter either RLO1 
(the default response) or RLO2. 


SYSGEN repeats this question for each device unit specified for each 
controller. 


* DM controller 0 [D:210,177440,,0] 


Enter the interrupt vector address (the default value is 210), the CSR 
address (the default value is 177440), the number of RK06/RK07 disk 
drives (there is no default for this parameter), and whether or not 
the controller is to support offset recovery (the default O is to 
include offset recovery support) for the first RK611 controller. 


The acceptable range for the number of RKO6/RKO7 drives is 1 through 
8(10). 


Offset recovery support provides a higher degree of data integrity in 
environments where disk packs are frequently moved from drive to 
drive. This support moves the disk head on either side of the 
cylinder center line in an attempt to pick up a stronger signal. 
Thus, offset recovery support allows data to be read in instances 
where it could not otherwise be read. 


If you do not use the default vector and CSR assignments, the 
acceptable range is 60 through 774 for the vector and 160000 through 
177700 for the CSR. 


There is no default CSR or vector address for subsequent RK611 
controllers. You must enter values, within the acceptable ranges, for 
the vector and CSR assignments as well as the number of RK06/RKO7 
drives. 
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NOTE 


You can specify offset recovery support only for the 
first controller. If you include support for the 
first RK611 controller, you automatically include 
offset recovery support for subsequent controllers. 
Likewise, if you exclude support, you exclude offset 
recovery support for subsequent RK611l controllers. 


* DM Contr 0 unit 0. is an RKO6/RKO07 [D:RK06] 


This question immediately follows parameter specification for each DM 
controller. You must specify the type of drive. Enter either RK06 
(the default response) or RKO7. 


SYSGEN repeats this question for each device unit specified for each 
controller. 


* DP controller 0 [D:254,176714] 


Enter the interrupt vector address (the default value is 254), the CSR 
address (the default value is 176714), and the number of RP02/RP03 
disk drives (there is no default for this parameter) for the first 
RP11l controller. 


The CSR for the DP device is not the first register in the DP register 
set. The default CSR address displayed with this question is the 
actual CSR address for this device. 


The acceptable range for the number of RPO2/RP03 disk drives is 1 
through 8(10). 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR or vector address for subsequent RP11l 
controllers. You must enter values, within the acceptable ranges, for 
the vector and CSR assignments as well as the number of RP02/RP03 
drives. 


* DP Contr 0 unit 0. is an RP02/RP03 [D:RPO03] 


This question immediately follows parameter specification for each DP 
controller. You must specify the type of drive. Enter either RPO2 or 
RPO3 (the default response). 


SYSGEN repeats this question for each device unit specified for each 
controller. 
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* DR controller 0 [D:254,176700,,0,0] 


Enter the interrupt vector address (the default is 254), the CSR 
address (the default is 176700), the number of 
RM02/RM03/RM05/RM80/RPO7 drives (there is no default for this 
parameter), the physical unit number of the first drive (the default 
is 0), and whether or not the controller supports offset recovery (the 
default is 0, for offset recovery) for the first RH11 or RH70 
controller. 


Offset recovery support provides a higher degree of data integrity in 
environments where disk packs are frequently moved from drive to 
drive. This support moves the disk head on either side of the 
cylinder center line in an attempt to pick up a stronger signal. 
Thus, offset recovery support allows data to be read in instances 
where it could not otherwise be read. 


If you use the default values (enter two commas (,,) followed by the 
number of drives), the acceptable range for the number of drives is 1 
through 8(10). 


If you do not use the default values, the acceptable ranges are: 


Vector 60 through 774 (8) 

CSR 160000 through 177700 (8) 
Number of drives 1 through 8 (10) 

Unit number of first drive 0 through 7(10) 

Offset recovery O or NO 


Subsequent RH11 or RH70 controllers default only the unit number of 
the first drive (0). 


NOTE 


You can specify offset recovery support only for the 
first DR controller. If you include support for the 
first controller, you automatically include offset 
recovery support for subsequent controllers. 
Likewise, if you exclude support, you exclude offset 
recovery support for subsequent controllers. 


* DR Contr 0 unit 0. is an RM02/03/05/80/RP07 [D:RM03] 


This question immediately follows parameter specification for each DR 
controller. You must specify the type of drive. Enter either RM02, 
RMO3 (the default response), RMO5, RM80, or RPO7. ; 


SYSGEN repeats this: question for each device unit specified for each 
controller. 
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* DS controller 0 [D:204,172040,,0] 


Enter the interrupt vector address (the default value is 204), the CSR 
address (the default value is 172040), the number of RS03/RS04 disk 
drives (there is no default value for this parameter), and the 
physical unit number of the first RS03/RS04 drive (the default value 
is 0) for the first RH11 or RH70 controller. 


The acceptable range for the number of RS03/RS04 drives is 1 through 
8(10). 


If you do not use the default values, the acceptable ranges are: 


Vector 60 through 774 (8) 

CSR 160000 through 177700 (8) 
Number of drives 1 through 8 (10) 

Unit number of first drive 0 through 7(10) 


Subsequent RH11 or RH70 controllers default only the unit number of 
the first drive (0). 


* DS Contr 0 unit 0. is an RSO3/RS04 [D:RS04] 


This question immediately follows parameter specification for each DS 
controller. You must specify the type of drive. Enter either RSO3 or 
RSO04 (the default response). 


SYSGEN repeats this question for each device unit specified for each 
controller. 


* DT controller 0 [D:214,177342] 


Enter the interrupt vector address (the default value is 214), the CSR 
address (the default value is 177342), and the number of DECtape 
drives (there is no default for this parameter) for the first TU56 
controller. 


The CSR for the DT device is not the first register in the DT register 
set. The default CSR address displayed with this question is the 
actual CSR address for this device. 


The acceptable range for the number of DECtape drives is 1 through 
8(10). 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


Subsequent TU56 controllers do not default the vector and CSR 
assignments. You must enter a value within the acceptable ranges for 
the vector and CSR assignments, as well as the number of drives. 
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* pU contr 0 [D:154,172150] 


Enter the interrupt vector address (the default value is 154), the CSR 
address (the default value is 172150), and the number of DU:-type 
(RA60/RA80/RA81/RC25/RD51/RD52/RX50/RX180) disk drives (there is no 
default value for this parameter). 


The acceptable range for the number of DU:-type drives for each 
controller is 1 through 4(10). 


An RC25 is both a fixed-media and a removable-media disk drive. 
Therefore, each RC25 is equivalent to two units. When you specify the 
number of DU:-type devices, count two units for each RC25 disk drive. 


It is recommended that you use extreme care if the RC25 is your system 
device. Because the RC25 is both a fixed-media and removable-media 
disk drive, it is unlike other disk drives used as system disks. For 
example, if you want to spin down the removable disk to replace it 
with another disk pack, the fixed-media disk (possibly your system 
disk) has to be stopped as well. Doing so could seriously disrupt 
system activities. 


Before you replace the removable-media disk, you must ensure that all 
I/O activity (system and user) has stopped on the fixed-media disk. 
Both the system and the system's users cannot access files at this 
time. Also, all read and write operations to the drive result in 
errors. For example, if you have a checkpoint file on the fixed unit 
and you spin down the removable unit, you must be sure that the system 
does not attempt to do a checkpoint read or a checkpoint write. The 
attempted checkpoint read results in a checkpoint read failure and the 
task is aborted. The attempted checkpoint write results in both error 
messages on the console and the checkpoint operation being terminated. 


For RD51/RX50 configurations, a DU controller can accept up to. four 
RD51/RX50 + units. However, SYSGEN does not accept an answer of fewer 
than three units (one RD51 fixed-media disk drive and two RxX50 
diskette drives). If you respond with either one or two units, SYSGEN 
forces three units into the system. 


NOTE 


An RD51/RX50 configuration requires one dedicated DU 
controller. No other DU devices (for example, an 
RA81) can be on that controller. Also, only two 
RD51/RX50 configurations are allowed per system. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR or vector address for subsequent UDA 
controllers. You must enter values, within the acceptable ranges, for 
the vector and CSR assignment as well as the number of UDA drives. on 
that controller. 
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* DX controller 0 [D:264,177170] 


Enter the interrupt vector address (the default value is 264), the CSR 
address (the default value is 177170), and the number of RX01 floppy 
disk drives (there is no default for this parameter) for the first 
RX11 controller. 


The acceptable range for the number of RX01 floppy disk drives is 1 
through 2(10). 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR or vector address for subsequent RX11l 
controllers. You must enter values, within the acceptable ranges, for 
the vector and CSR assignments as well as the number of RX0l_ floppy 
disk drives. 


* DY controller 0 [D:264,177170] 


Enter the interrupt vector address (the default value is 264), the CSR 
address (the default value is 177170), and the number of Rx02 floppy 
disk drives (there is no default for this parameter) for the first 
RX211/RXV21/RXV12 controller. . 


The acceptable range for the number of Rx02 floppy disk drives is 1 
through 2(10). 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR or vector address for subsequent 
RX211/RXV21/RXV12 controllers. you must enter values, within the 
acceptable ranges, for the vector and CSR assignments as well as_ the 
number of RX02 floppy disk drives. 


Note that the RXV21, the RX02 controller for the LSI-1l1 bus, does not 
support 22-bit addressing because it cannot perform direct-memory 
access for the total range of addresses on a 22-bit system. Using the 
RXV21 controller on a 22-bit LSI-11 bus sytem will crash the system. 


* EM controller 0 [D: ,176400] 


Enter the interrupt vector address (there is no default for the 
interrupt vector), the CSR address (the default address is 176400), 
and the number of ML11 disk drives (there is no default for this 
parameter). 
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If you do not use the default values, the acceptable rangeS are as 
follows: 


Vector 60 through 744 (8) 
CSR 160000 through 177700 (8) 
Number of ML11 drives 1 through 8(10) 


* GR controller 0 [{D:,172000,,1] 


RSX-11M supports the graphics display subsystem with the following 
restrictions: 


e There is one, and only one, VT1l or VS60 in the system. 


e The graphics display driver does not operate on any processors 
in 22-bit mode. Memory size must be less than or equal to 
124K words. 


e For systems using the VTll, the display buffer of the task 
driving the VT11 must completely reside in the low 28K words 
of system memory. 


e The graphics display driver is always resident. 


The vector address for the graphics display subsystem is assigned from 
the floating vector space starting at 300. Thus, there is no default 
vector address for the graphics display subsystem. Enter a vector 
address in the range 300 through 774. Consult your DIGITAL Field 
Service representative if the vector address is unknown. 


After you specify the vector address, enter the CSR address (the 
default value is 172000), whether the connected terminal is a VTll or 
a VS60 (there is no default for this parameter), and the number of CRT 
monitors (the default is 1). 


If you do not enter the default CSR address and the number of CRT 
monitors, the acceptable range is 160000 through 177700 for the CSR 
and 1 through 2 for the number of CRT monitors. 


NOTE 


Only the vs60 can drive two CRT monitors 
independently. Thus, if your system includes the 
VT11, you must specify the default value of 1 for the 
number of CRT monitors. 


* LA controller 0 [{D:300,170460,0] 


Enter the interrupt vector address (the default value is 300), the CSR 
address (the default value is 170460), and the number of UNIBUS 
Mapping Registers (UMRs) for the LPA11-K. 
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The UMR parameter applies only to UNIBUS processors with extended 
memory (22-bit mapping) support. Enter a value to specify the maximum 
number of UMRsS that the LPA1l1-K driver can use to map all concurrently 
active LPA11-K I/O transfers. If the processor does not have extended 
memory, the default for this parameter is 0. If the processor does 
have extended memory, but the system does not include support for the 
20K-word Executive, the default for this parameter is 4; otherwise, 
the default is 5. See the RSX-11M/M-PLUS I/O Drivers Reference Manual 
for details. Gey ee at Ge eS 


There is no default CSR or vector address for subsequent LA 
controllers. You must enter values within the acceptable ranges for 
the vector and CSR addresses as well as the number of UNIBUS Mapping 
Registers for the LPA11-K. 


NOTE 


The vector address is assigned from floating vector 
space. Consult your DIGITAL Field Service 
representative if the location is unknown. Also, the 
required CSR address is that of the first word of the 
LPA11 CSR group. 


If you include an LA device in your system, SYSGEN automatically 
includes support for the Send/Receive directive (Question 37, Code C, 
Executive Options Section). 


See Section 4.8.1 for the IC and IS Subsystems questions and Questions 
2A and 2B in the System Options Section for the IP11 Subsystem 
questions. 


* LP controller 0 [D:200,177514,LA180,0,300,160130] 


Enter the interrupt vector address (the default value is 200), the CSR 
address default value is 177514) and the controller option (the 
default option is LA180) for the first line printer controller. Valid 
controller options are described in Table 4-3. 


For printer widths and speed, consult your DIGITAL Field Service 
representative or the PDP-1ll Peripherals Handbook. 


The LP1l1-F and LP11-H printer options have a column width of only 8:0 
chracters. These printer options print only the first 80 characters 
of a print line. 


The LP11-A, -C, -F, -J, -R, -V, -Y¥, and LS1ll printer options may not 
print lowercase characters. If they do not, lowercase characters are 
printed as spaces. 


If your target system configuration includes an LP1ll1-A, -B, -C, -D, 
-E, -V, -W, -Y, <-Z, LS11, or LA180 printer option, but you did not 
specify that particular printer option, a print line may be lost (not 
printed) when the line printer is turned off line. 
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If your target system configuration includes an LP1l1-F, -H, -J, -K, 
-R, -S or LVll, but you did not specify that particular printer 
option, a file may take about 25 percent longer to print than if you 
specify the correct printer option. 


If your system includes KMC line printer support, you must enter’ the 
KMC time-out count (the default of 0 excludes KMC support), the KMC 
interrupt vector address (the default value is 300), and the KMC CSR 
address (the default value is 160130). 


The time-out count specifies the interval in which the KMC polls’ the 
line printer between printed lines. This value is measured in units 
of 50 microseconds. For example, if you enter 1, the KMC polls’ the 
line printer every 100 microseconds (as each print buffer empties). 
The acceptable range is 0 through 100(10). For slower printers, poll 
less frequently (enter a higher number). The polling interval 
increases or decreases UNIBUS latency. 


Table 4-3 
Standard Line Printer Devices 


Option Printer Column Width Character Set Lines/Minute 
LPl1-A  —- LP25-A 132 64 285 
LP11-B LP25-B 132 96 204 
LP1l-c  +LP14-C 132 64 890 
LP1l1-D LP14-D 132 96 650 
LP1l-E  LP26-E 132 96 420-600 
LP1l-F _ LPO1-F 80 64 170-1110 
LP1l1-G  LPO7-G 132 96 1200 
LP1l-H -LPO1-H 80 96 170-1110 
LPll-J = Lp02-J 132 64 170-1110 
LP1l-K  _LP02-K 132 96 170-1110 
LP11-R — LPO4-R 132 64 1110 
LP1l-S _ LP04-S 132 96 1110 
LPll-U  —«LP27-U 132 96 800-1200 
LP11-V.—sLPO5-V 132 64 300 


1. You can connect a maximum of eight line printers to the system. 


(Continued on next page) 
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Table 4-3 (Cont.) 
Standard Line Printer Devices 


Option Printer l Column Width Character Set Lines/Minute 
LP11-W LPO5-W 132 96 300 

LP11-Y LP06-Y 132 64 600 

LP11-Z LP06-Z 132 96 460 

LNOL1 LNO1 132 96 12 pages 
LS11 LS11 132 62 60-200 

LV11 LVOL1 132 96 500 

LA180 LA180 132 96 150 


1. You can connect a maximum of eight line printers to the system. 


The acceptable range for the KMC interrupt vector address is 60 
through 774 and the range for the KMC CSR address is 160000 through 
177700. 


NOTE 


If you select KMC support, all printers must use the 
KMC. Those that do not use the KMC cannot operate. 
You must respecify KMC parameters for each additional 
line printer controller question asked by SYSGEN. 


* LS controller 0 [D:,170400,,,0,0,0,NO] 


The clock vector address for the LPS1l1 controller is assigned from the 
floating vector space starting at 300. It is located at an offset of 
four (4) from the beginning of the LPS1l1 vector space. Thus, there is 
no default clock vector address for the LPS11. Enter a clock vector 
address in the range 300 through 774. Consult your DIGITAL Field 
Service representative if the clock vector address is unknown. 


The standard CSR address for the LPS11 is 170400. Specify the address 
of the first word of the LPS11 CSR group (the default value is 
170400). If you do not enter the default CSR address, the acceptable 
range is 160000 through 177700. 


The next parameter is the number of A/D channels. Enter a value in 
the range 1 through 64(10) to specify the number of A/D channels on 
the first LPS11 controller. 


You must then enter whether or not the gain ranging option is present. 
If the gain ranging option is present, you must specify the polarity 
mask word and the bandwidth filter channel select delay (if required). 


The polarity mask word specifies whether an individual channel is 
unipolar or bipolar; it corresponds one-to-one with the 16 possible 
channels. A 11-bit designates a unipolar channel and a O-bit 
designates a bipolar channel. The acceptable range for the polarity 
mask word is 0 through 177777 (0 specifies 16 bipolar channels, 177777 
specifies 16 unipolar channels). 


DETAILS OF SYSGEN PHASE I 


PERIPHERAL OPTIONS (Cont.) 


With bandwidth filtering enabled, the LPS1l1 driver imposes a_ software 
delay between changing channels on the multiplexer and initiating an 
A/D conversion. This delay can range from 85 microseconds to 8.5 
milliseconds. Consult the LPS11 documentation to determine the proper 
delay for your application. Note that the response must be in 100 
microsecond units (for example, specify 25 to delay 2.5 milliseconds). 
The acceptable range is 0 through 85. Enter 0 to disable bandwidth 
filtering. 


If your system includes the D/A option, enter the number of channels 
in the range OQ through 10(10). A response of 0 (the default) 
indicates the option is not present. The first two D/A channels 
correspond to the X and Y registers of the display controller. Up to 
eight additional D/A channels may be specified if the external D/A 
option is present. 


The LPS11 supports a digital I/O and relay module. You must’ specify 
whether or not the option is present. If the digital I/O and relay 
module is present, enter D; otherwise enter No. You then enter’ the 
maximum number of samples per _ second. The acceptable range is 1 
through 2500(10). Note that this value must be a factor of 10,000 (1, 
2, 4, 5, 8, 10, 16, 20, 25, 40, 50, 80, 100, 125, 200, 250, 400, 500, 
625, 1000, 1250, 2000, or 2500). 


* MM controller 0 [D:224,172440] 


Enter the interrupt vector address (the default value is 224), the CSR 
address (the default value is 172440), and the number of TU45, TU16, 
TE16, or TU77 magnetic tape drives (there is no default for this 
parameter) for the first RH11 or RH70 controller. 


The acceptable range for the number of tape drives is 1 through 8. 


If you do not enter the default vector and CSR assignments, the 
acceptable range is 60 through 774 for the vector and 160000 through 
177700 for the CSR. 


There is no default CSR or vector address for subsequent controllers. 
You must enter values, within the acceptable ranges, for the vector 
and CSR assignments as well as the number of tape drives. 


* MM controller 0O unit 0 formatter [D R:0-7 D:0] 


Each MM controller supports up to eight formatters. Each 1TM02/03 
formatter supports up to eight units (except for TU77 drives, which 
support up through four drives). When you specify the number of units 
in the preceding question, SYSGEN asks this question to determine 
which TM02/TM03 formatters connect to which units (drives). 


This question immediately follows parameter specification for each MM 
controller. You must identify the number (the unit plug) for the 
TM02/TM03 formatter (tape controller) on the RH11 or _  RH70. The 
default is 0. If you do not use the default response, the acceptable 
range is 0 through 7(10), or 0 through 3(10) for TU77 drives. 


SYSGEN repeats this question for each device unit specified for each 
controller. 
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* MS controller 0 [D:224,172522] 


Enter the interrupt vector address (the default value is 224) and the 


CSR address (the default value is 172522) for the first tTS11 
controller. 


The CSR for the MS device is not the first register in the MS register 
set. The default CSR address displayed with this question is the 
actual CSR address for this device. 


If you do not enter the default values for the vector and CSR 


assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


Subsequent TS1l controllers do not default the vector and CSR 
assignments. You must enter a value within the acceptable range. 


The TS11, TSVO5, and TU80 magnetic tape drives are valid MS:-type 
devices. 


* MT controller 0 [D:224,172522] 


Enter the interrupt vector address (the default value is 224), the CSR 
address (the default value is 172522), and the number of TS03, TU10, 
or TE10 magnetic tape drives (there is no default for this parameter) 
for the first TM11, TMA1l1, or TMB11 controller. 


The CSR for the MT device is not the first register in the MT register 
set. The default CSR address displayed with this question is the 
actual CSR address for this device. 


The acceptable range for the number of tape drives is 1 through 8. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR or vector address for subsequent MT 
controllers. You must enter values, within the acceptable ranges, for 
the vector and CSR assignments as well as the number of tape drives. 


* MU controller 0 [D:260,174500] 


Enter the interrupt vector address (the default value is 260) and the 
CSR address (the default value is 174500) for the controller. 


If you do not enter the default value for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


There is no default CSR or vector address for subsequent MU 


controllers. You must enter values, within the acceptable ranges, for 
the vector and CSR assignments. 
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* PP controller 0 [D:74,177554] 


Enter the interrupt vector address (the default value is 74) and _ the 


CSR address (the default value is 177554) for the first PCll 
controller. 


The CSR for the PP device is not the first register in the PP register 
set. The default CSR address displayed with this question is the 
actual CSR address for this device. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


Subsequent PCll controllers do not default the vector and CSR 
assignments. You must enter values within the acceptable ranges. 


* PR controller 0 [D:70,177550] 


Enter the interrupt vector address (the default value is 70) and _ the 
CSR address (the default value is 177550) for the first PC11/PR11 
controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 


Subsequent PC11/PR11 controllers do not default vector and CSR 
assignments. You must enter a value within the acceptable range. 

* UD controller 0 [D:234,171776] 

Enter the interrupt vector address (the default value is 234) and the 
CSR address (the default value is 171776) for the UDC11 controller. 

If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60 through 774 for the vector and 
160000 through 177700 for the CSR. 

After you specify the interrupt vector address and the CSR address for 
the UDCll, SYSGEN immediately prompts for UDC11 module information. 
For clarity, this section lists the prompt lines in numeric order, not 
in logical sequence. If you were performing a SYSGEN and included a 
UDC11 controller, the questions for UDC1l would follow the vector and 
CSR assignments. 


The UDCl1 supports up to 252(10) modules, which can be classified into 
seven types: 


e Analog input 
e Analog output 
e Bi-stable output 


e Digital interrupt 
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e Digital sense 

e I/0 counter 

e Single-shot output 
Modules of the same type must occupy consecutive locations within the 
UDC1I1. Thus, if there are seven analog input modules and the first 
module starts at slot 0, then the last analog input module must be at 
slot 6. Module types cannot overlap, but unassigned slots are 
permitted. 
You must enter the number of each module contained in the UDC11l and 
identify the first slot for that module. The permissible range for 
each entry is 0 through 252(10). Note, however, that | SYSGEN 
decrements the range value for the number of each module by the total 
number of previously specified UDC1l modules. For example, if you 
specify 50 analog input modules, you are limited to 152 of the other 
modules (maximum 252 UDC11 modules). 


SYSGEN asks the following questions to establish UDC11l module 
boundaries: 


e UD controller 0 ADUO] analog input module 
e UD controller 0 analog output iedube 

e UD controller 0 bi-stable output module 

@e UD controller 0 digital interrupt module 
e UD controller 0 digital sense module 

e UD controller 0 I/O counter module 


e UD controller 0 single-shot output module 
* XB controller 0 [D:124,172414] 


Enter the interrupt vector address (the default value is 124) and the 
CSR address (the default value is 172414) for the first DA11-B 
interface, 


If you do not enter the default for the vector and CSR assignments, 
the acceptable range is 60 through 774 for the vector and 160000 
through 177700 for the CSR. 


Subsequent DA11-B interfaces do not default the vector and CSR 
assignments. You must enter values within the acceptable ranges. 


* XE controller 0 [D:,,0] 


Enter the interrupt vector address, the CSR address, and the number of 
DEUNA Ethernet controllers in the target configuration. 
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The interrupt vector address for the DEUNA controller is assigned from 
floating vector space starting at 300. Thus, there is no default 
vector address for the DEUNA. Enter a vector address in the range 300 
through 774. Consult your DIGITAL Field Service representative if the 
vector address is unknown. 


The CSR address is assigned from floating address space starting at 
160010. Thus, there is no default CSR assignment for the DEUNA. 
Enter a CSR address in the range 160010 through 177700. Consult your 
DIGITAL Field Service representative if the CSR address is unknown. 


The default number of DEUNA Ethernet controllers is none (0). 
* XL controller 0 [D:,,H] 


The vector address for the DL11-E asynchronous line interface is 
assigned from the floating vector space starting at 300. Thus, there 
is no default vector address for the DL11-E. Enter a vector address 
in the range 300 through 774. Consult your DIGITAL Field Service 
representative if the vector address is unknown. 


The CSR address for the DL11-E asynchronous line interface is assigned 
from the floating address space starting at 175610. Thus, there is no 
default CSR assignment for the DL11-E. Enter a CSR address in the 
range 175610 through 177700. Refer to Appendix E or consult your 
DIGITAL Field Service representative if the CSR address is unknown. 


The first DL11-E line defaults to a half-duplex line (H). Enter F_ to 
specify a full-duplex line. 


There is no default value for the parameter that specifies the 
required number of synchronous’ characters in a synchronous leader. 
You must enter a value in the range 3 through 14(10). A typical 
response is 4 through 6. If the line is to run at high speeds or if 
the expected system load is to be heavy, specify a greater number of 
synchronous characters. 


There are no default parameters for subsequent DL11-E lines. You must 
enter values for the vector and CSR assignments. 


* XM controller 0 


The vector address for the DMC1l interprocessor link is assigned from 
the floating vector space starting at 300. Thus, there is no default 
interrupt vector address for the DMC1l1l. Enter a vector address in the 
range 300 through 774. Consult your DIGITAL Field Service 
representative if the vector address is unknown. 


The CSR address for the DMCll1 interprocessor link is assigned from the 
floating address space starting at 160010. Thus, there is no default 
CSR assignment for the DMCll. Enter a CSR address in the range 160010 
through 177700. Consult your DIGITAL Field Service representative if 
the CSR address is unknown or see Appendix E. 


Normally, the DMC11 is a full-duplex serial communications link. When 
the DMC1l1l is used on a half-duplex line, one end of the line must be 
the primary station and the other end must be the secondary station. 


DETAILS OF SYSGEN PHASE I 


PERIPHERAL OPTIONS (Cont.) 


Specify an F to indicate that the line is full-duplex, an H_ to 
indicate that the line is a secondary station half-duplex, or P to 
indicate that the line is a primary station half-duplex. 


* XP controller 0 [D:,174770,H] 


The vector address for the DP1l synchronous line interface is assigned 
from the floating vector space starting at 300. Thus, there is no 
default interrupt vector address for the DPll. Enter a vector address 
in the range 300 through 774. Consult your DIGITAL Field Service 
representative if the vector address is unknown or see Appendix E. 


The standard CSR assignment for the DP1ll is 174770. If you do not 


enter the default CSR address, enter a value in the range 160000 
through 177700. 


The first DPll line defaults to a half-duplex line (H). Enter F to 
specify a full-duplex line. 


There is no default value for the parameter that specifies the 
required number of synchronous characters in a synchronous leader. 
You must enter a value in the range 3 through 14(10). A typical 
response is 4 through 6. If the line is to run at high speeds or if 
the expected system load is to be heavy, specify a greater number of 
synchronous characters. 


Subsequent DP1l1l lines default only the half-duplex parameter (H). You 
must enter values for the vector and CSR assignments. 


* XQ controller 0O [D:,,H,E,C] 


The vector address for the DQ11 synchronous line interface is assigned 
from the floating vector space starting at 300. Thus, there is no 
default vector address for the DQI1. Enter a vector address in the 
range 300 through 774. Consult your DIGITAL Field Service 
representative if the vector address is unknown or see Appendix E. 


The CSR address for the DQ11 synchronous line interface is assigned 
from the floating address space starting at 160010. fThus, there is no 
default CSR assignment for the DQ11. Enter a CSR address in the range 
160010 through 177700. Consult your DIGITAL Field Service 
representative if the CSR address is unknown. 


The first DQ11 line defaults to a half-duplex line (H) with an _ error 
detection expander unit (E) and a character detection expander unit 
(C). Enter F, NO, or NO respectively to override these defaults. 


There is no default value for the parameter that specifies the 
required number of synchronous characters in a synchronous leader. 
You must enter a value in the range 3 through 14(10). A typical 
response is 4 through 6. If the line is to run at high speeds or if 
the expected system load is to be heavy, specify a greater number of 
synchronous characters. 


DETAILS OF SYSGEN PHASE I 


PERIPHERAL OPTIONS (Cont.) 


Subsequent DQ11 lines do not default any of the parameters. You must 
enter values for the vector and CSR assignments. 


* XU controller 0 [D:,,F] 


The vector address for the DU11 synchronous line interface is assigned 
from the floating vector space starting at 300. Thus, there is no 
default interrupt vector address for the DU11. Enter a vector address 
in the range 300 through 774. Consult your DIGITAL Field Service 
representative if the vector address is unknown or see Appendix E. 


The CSR address for the DU11 synchronous line interface is assigned 
from the floating address space starting at 160010. MThus, there is no 
default CSR assignment for the DU11. Enter a CSR address in the range 
160010 through 177700. Consult your DIGITAL Field Service 
representative if the CSR address is unknown or see Appendix E. 


The first DU11 line defaults to a full-duplex line (F). Enter H_ to 
specify a half-duplex line. 


There is no default value for the parameter that specifies the 
required number of synchronous’ characters in a synchronous leader. 
You must enter a value in the range 3 through 14(10). A typical 
response is 4 through 6. If the line is to run at high speeds or if 
the expected system load is to be heavy, specify a greater number of 
synchronous characters. 


Subsequent DU11 lines default only the full-duplex parameter (F). You 
must enter values for the vector and CSR assignments. 


* XW controller 0 [D:,,H] 


The vector address for the DUP11 synchronous line interface is 
assigned from the floating vector space starting at 300. Thus, there 
is no default interrupt vector address for the DUP11. Enter a_ vector 
address in the range 300 through 774. Consult your DIGITAL Field 
Service representative if the vector address is unknown or_ see 
Appendix E. 


The CSR address for the DUP11 synchronous line interface is assigned 
from the floating address space starting at 160010. MThus, there is no 
default CSR assignment for the DUP11. Enter a CSR address in the 
range 160010 through 177700. Consult your DIGITAL Field Service 
representative if the CSR address is unknown or see Appendix E. 


The first DUP11 line defaults to a half-duplex line (H). Enter F to 
specify a full-duplex line. 


There is no default for the parameter that specifies the required 
number of synchronous’ characters in a synchronous leader. You must 
enter a value in the range 3 through 14(10). A typical response is 4 
through 6. If the line is to run at high speeds or if the expected 
system load is to be heavy, specify a greater number of synchronous 
characters. 


Subsequent DUP11 lines do not default any of the parameters. You must 
enter values for the vector and CSR assignments. 


DETAILS OF SYSGEN PHASE I 


PERIPHERAL OPTIONS (Cont.) 


* YH controller 0 [D:,,,300,0,0] 


This question appears only if you specified a DH11 asynchronous’ line 
interface (YH) and have a UNIBUS processor (for example, PDP-11/24, 
PDP 11/44, or PDP 11/70). Note that the Loadable/Resident parameter 
does not appear. 


Enter the interrupt vector address (no default), the CSR address (no 
default), the number of lines (no default), the DM11-BB interrupt 
vector address (no default), and the DM11~-BB CSR address (no default). 


The interrupt vector address for the DH11 is assigned from floating 
vector space starting at location 300. Thus, there is no default 
vector assignment for the DH11. Enter a vector address in the range 
300 through 774. Consult your DIGITAL Field Service representative if 
the interrupt vector address is unknown or see Appendix E. 


The CSR address for the DH11 is assigned from floating address space 
Starting at 160010. Thus, there is no default CSR assignment for the 
DH11. Enter a CSR address in the range 160010 through 177700. 
Consult your DIGITAL Field Service representative if the CSR address 
is unknown or see Appendix E. 


The DH1l1 can service up to 16 remote and local lines. Enter the total 
number of lines desired by specifying the highest line number in the 
range 0 through 15(10) (0 indicates one line, 15 indicates 16 lines). 


If your DH11 includes DM11-BB modem support, you must enter the baud 
rate for all DH11 remote lines. The default answer speed (baud rate) 
is 300. (This speed can be changed later on an individual line basis 
using the MCR or VMR SET /REMOTE command.) If you do not use the 
default response, the acceptable answer speeds (baud rates) are 50, 
75, 110, 134.5, 150, 200, 300, 600, 1200, 1800, 2400, 4800, or 9600. 
You must also specify the DM11-BB vector and CSR assignments. The 
default response of 0 excludes DM11-BB modem support. 


To include DM11-BB modem support, you must enter a value for the 
vector and CSR assignments. The DM11-BB interrupt vector address is 
assigned from floating vector space starting at 300. Thus, you must 
enter a value in the range 300 through 774 to include DM11-BB modem 
support. Consult your DIGITAL Field Service representative if . the 
interrupt vector address is unknown or see Appendix E. 


The standard CSR address for the DM11-BB is 170500. If you include 
DM11-BB support, enter 170500 or a value within the range 160000 
through 177700 for the CSR assignment. 


SYSGEN repeats this question for each DH11 specified. 
* YJ controller 0 


This question appears only if you specified a DJ11 (YJ) asynchronous 
line multiplexer. Note that the Loadable/Resident parameter does not 
appear because the DJ1ll uses the same driver as the DL11 and the DH1l. 


DETAILS OF SYSGEN PHASE I 


PERIPHERAL OPTIONS (Cont.) 


The interrupt vector address for the DJ1l is assigned from floating 
vector space starting at 300. Thus, there is no default vector 
assignment for the DJ1l. Enter a vector address in the range 300 
through 774. Consult your DIGITAL Field Service representative if the 
vector address is unknown or see Appendix E. 


The CSR address for the DJ11 is assigned from floating address space 
starting at 160010. Thus, there is no default CSR assignment for the 
DJ11. Enter a CSR address in the range 160010 through 177700. 
Consult your DIGITAL Field Service representative if the CSR address 
is unknown or see Appendix E. 


Each DJ1l can service up to 16 asynchronous serial lines. Enter the 
total number of lines by specifying the highest line number in the 
range 0 through 15(10) (0 indicates one line, 15 indicates 16 lines). 


SYSGEN repeats this question for each DJ1l specified. 
* YL controller 0 [D:60,177560, NO] 


This question always appears because you must include at least one 
DL11 (YL) asynchronous line interface in an RSX-11M system. 


The default interrupt vector address for the first DL11 line is 60. 


If you do not use the default vector assignment, the acceptable range 
is 60 through 774. 


The default CSR address for the first DL11 line is 177560. If you do 
not use the default CSR assignment, the acceptable range is 160000 
through 177700. 


If your DL11 includes modem support (that is, if you have a DLIL1-E or 
a DLV11-E), enter E; otherwise, enter No. The remote speed of the 
DL11 is determined by the hardware and cannot be changed using 
software. 


If you specify more than one DL11, you must enter the vector and CSR 
assignment for each additional line. 


Interrupt vector addresses for additional DL11 lines are assigned from 
the floating vector space starting at 300. There is no default vector 
address for any additional DL11 lines. You must enter a value within 
the range 300 through 774. Consult your DIGITAL Field Service 
representative if the interrupt vector address of additional lines is 
unknown or see Appendix E. 


CSR addresses for additional DL11 lines are assigned from floating 
address space starting at 176000. There is no default CSR address for 
any additional DL11 lines. You must enter a value within the range 
176000 through 176770. Consult your DIGITAL Field Service 
representative if the CSR address of additional lines is unknown or 
see Appendix E. 


* YV controller 0 [,,,] 
This question appears only if you specified a DHU11l or DHV11 


asynchronous line interface (YV) and have a Q-BUS processor (for 
example, an LSI-11, PDP-11/03, PDP~11/23, or PDP-11/23-PLUS). 
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The DHV11 is the Q-BUS equivalent to the UNIBUS DH11 (refer to the 
previous question about YH). Unlike the DH11, the DHV11 does not have 
DM11-BB modem support. Also, the DHV11 baud rates differ from those 
of the DH1ll. 


The DHU11 is the UNIBUS equivalent of the DHV11. 


Enter the interrupt vector address (no default), the CSR address (no 
default), the number of lines (no default), and the baud rate (the 
default is 0). 


The interrupt vector address for the DHU11/DHV1l is assigned from 
floating vector space starting at location 300. Thus, there is no 
default vector assignment for the DHU1L1/DHV11. Enter a vector address 
in the range 300 through 770. Consult your DIGITAL Field Service 
representative if the interrupt vector address is unknown. 


The CSR address for the DHU1L1/DHV11 is assigned from the floating 
address space starting at 160010. Thus, there is no default CSR 
assignment for the DHU11/DHV11. Enter a CSR address in the range 
160010 through 177700. Consult your DIGITAL Field Service 
representative if the CSR address is unknown. 


The DHU11 can service up to 16 remote and local lines. Enter the 
total number of lines desired by specifying the highest line number in 
the range 0 through 15 (0 indicates one line, 15 indicates 16 lines). 


The DHV1l1 can service up to 8 remote and local lines. Enter the total 
number of lines desired by specifying the highest line number in the 
range 0 through 7 (0 indicates one line, 7 indicates 8 lines). 


The DHU11/DHV11 can maintain a full-duplex connection through a _ Bell 
103A-type modem. However, modem support requires additional code in 
the terminal driver and thus increases system overhead. Select modem 
support only if needed. If you want to include modem support, specify 
the baud rate for all DHU11/DHV11 remote lines. Acceptable answer 
speeds (baud rates) are 75, 110, 134.5, 150, 300, 600, 1200, 1800, 
2000, 2400, 4800, 9600, or 19200. This speed can be changed later on 
an individual line basis using the MCR or VMR SET /REMOTE command. 
Note that the default for this parameter (0) excludes modem support. 


SYSGEN repeats this question for each DHU11/DHV11 specified. 


NOTE 


If you include a DHU11/DHV11 in your system, SYSGEN 
automatically includes the full-duplex terminal driver 
(Question 1, Option C, Terminal Driver Options 
Section). 


* YZ controller 0 [D:,,,0] 


This question appears only if you specified a DZ11/DZQ11/DZV11l (YZ) 
asynchronous line multiplexer. Note that the Loadable/Resident 
parameter does not appear. 
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The interrupt vector address for the DZ11/DZQ11/DZV1l is assigned from 
floating vector space starting at 300. Thus, there is no default 
vector assignment for the DZ11/D2Q11/DZV1l. Enter a vector address in 
the range 300 through 774. Consult your DIGITAL Field Service 
representative if the vector address is unknown or see Appendix E. 


The CSR address for the DZ11/DZQ11/DZV1l is assigned from floating 
address space starting at 160010. Thus, there is no default CSR 
assignment for the DZ11/DZQ11/DZV11l. Enter a CSR address in the range 
160010 through 177700. Consult your DIGITAL Field Service 
representative if the CSR address is unknown or see Appendix E. 


Each DZ11 can service up to eight asynchronous lines. Enter the total 
number of lines by specifying the highest line number in the range 0 
through 7(10) (0 indicates one line, 7 indicates eight lines). 


Each DZQ11 can service up to four asynchronous lines. Enter the total 
number of lines by specifying the line number in the range 0 through 
4. 


Each DZV11 can service up to four asynchronous lines. Enter the total 
number of lines by specifying the highest line number in the range 0 
through 3(10) (0 indicates one line, 3 indicates four lines). 


The DZ11/DZQ11/DZV11l can maintain a full-duplex connection through a 
Bell 103A-type modem. However, modem support requires additional code 
in the terminal driver and thus increases system overhead. Select 
modem support only if needed. If you want to include modem support, 
specify only one baud rate for all DZ11/DZQ11/DZV11 remote lines. 
Acceptable answer speeds (baud rates) are 50, 75, 110, 134.5, 150, 
200, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, or 9600. 
This speed can be later changed on an individual line basis using the 
MCR or VMR SET /REMOTE command. Note that the default for this 
parameter (0) excludes modem support. 


SYSGEN repeats this question for each DZ11/DZQ11/DZV1l specified. 


4.8.1 IC and IS Subsystems 


If your system includes ICS/ICR process I/O subsystems or DSS/DRS 
modules, SYSGEN asks the following questions. Note that UDC11 support 
precludes ICS/ICR support. ICS/ICR and UDCll1 are mutually exclusive. 


* 1. Expanded comments for ICS/ICR questions? 


Ex panded comments provide explanatory text that helps you answer the 
ICS/ICR questions. 


* 2. Do you want task activation from unsolicited interrupts? 


This option permits the ICS/ICR driver to initiate a task when the 
driver receives unsolicited input. The option provides support for 
tasks to link to interrupts and obtain activation data upon 
initiation. 
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* 3. IC controller 0 vector address: 


The standard vector address for the ICS/ICR subsystem is 234. Enter a 
value within the range 234 through 774. Subsequent IC controllers 
obtain vector assignments from floating vector space starting at 300. 


Consult your DIGITAL Field Service representative if the vector 
addresses are unknown. . 


* 4. CSR address: 


The standard CSR address for the ICS/ICR subsystem is 171776. Enter a 
value within the range 160000 through 177700. CSR addresses for 
subsequent IC controllers are assigned starting at 171766 and proceed 
downward in eight-byte intervals (for example, 171766, 171756, and 
171746). 


* 5. Is it an ICR-11? 


Specify whether the subsystem is an ICR-l1l or an ICS-1l. SYSGEN 
repeats this question for each IC controller specified. 


* 6. Number of A/D converter modules in this ICS/ICR: 


The ICS/ICR subsystem supports up to 16 A/D converter modules, each 
with 8 channels. Enter a value in the range 0 through 16(10). If you 
enter a non-zero value, SYSGEN asks Question 7. SYSGEN repeats 
Question 6 and, if applicable, Question 7, for each IC controller 
specified. 


* 7. A/D converter module number s 

Enter the module number in the range 0 through 15(decimal). 
* 8. Number of expansion multiplexers: 

Enter a value in the range 0 through 7. 

* 9. (<module name>) module number 


This question appears for each module you include (that is, if you 
enter non-zero values for Questions 12 through 19). Enter a value in 
the range 0 through 15(decimal). 
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* 10. Restore module status on power and error recovery? 


This question appears only if the system includes a bi-stable output, 
D/A converter, or I/O counter module. 

If you select this option, the ICS/ICR driver restores the state of 
all bi-stable digital outputs, analog outputs, and I/O prescalar 


values on power recovery and recovery from sustained serial 
transmission errors. 


* 11. How many line errors are acceptable per second? 


This question appears only if you include the restore module status 
option (respond Yes to Question 10). 


When serial line errors exceed the limit you specify in response to 
this question, the IC driver places the affected subsystem off line 
(when the line errors cease, the driver automatically places’ the 
Subsystem on line). 
Enter a value in the range 0 through 5000(decimal). 
The ICS/ICR subsystem consists of six distinct modules: 

@e D/A converter 

e Single-shot output 

e Bi-stable output 

e Digital sense 

@e Digital interrupt 

e 1/0 counter 
SYSGEN prompts for the sanber of each module in your system (in 


Questions 12 through 17) and then asks for the module number of each 
(in Question 9). 


* 12. Number of D/A converter modules in this ICS/ICR: 

* 13. Number of single-shot output modules in this ICS/ICR: 
* 14. Number of bi-stable output modules in this ICS/ICR: 

* 15. Number of digital sense modules in this ICS/ICR: 


* 16. Number of digital interrupt modules in this ICS/ICR: 
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* 17. Number of I/O counter modules in this ICS/ICR: 
* 18. Expanded comments for DSS/DRS questions? 


Expanded comments provide explanatory text that helps you answer the 
DSS/DRS questions. 


* 19. Number of DRS-11 modules: 


Enter the number of DRS-1l digital output modules in the range 0 
through 16 (decimal). If you enter 0, SYSGEN omits Questions 20, 21, 
and 22. 


* 20. Restore module status on power and error recovery? 


If you select this option, the DRS driver restores the state of all 48 
buffered digital output modules on power recovery and recovery from 
sustained transmission errors. 


* 21. DRS-11 CSR address: 


Enter a value for the CSR address in the range 160000 through 177700. 
* 22. DRS-11 vector address: 


Enter a value for the vector address in the range 300 through 774. 
This question appears for each individual module you specify. 


/ 


* 23. Number of DSS-11 digital input modules: 


Enter the number of DSS-11 digital input modules. Note that the total 
number of DRS-11 and DSS-11 modules cannot exceed 16. Thus, the 
acceptable range for this response is 0 through 16 (decimal). minus 
the number of DRS-11 modules specified in Question 19. If you enter 
0, SYSGEN omits Questions 24, 25, and 26. 


* 24. DSS-11 CSR address: 
Enter a value for the CSR address in the range 160000 through 177700. 
* 25. DSS-11 vector address: 


Enter a value for the vector address in the range 300 through 774. 
This question appears for each individual module you specify. 
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* 26. Task activation from unsolicited interrupts? 


This option permits the DSS/DRS driver to initiate a task when the 
driver receives unsolicited input. The option provides support for 
tasks to link to interrupts and obtain activation data upon 
initiation. 
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>@SYSGEN @ 


; RSX-1LIM V4.2 BL38 System Generation PHASE I -- Version 2.10 


>; 12-JUN-85 13:46:03 
; Big disk distribution kit 


>* 3. Do you want to inhibit execution of MCR commands (PREPGEN)? [Y/N]: y @ 
>* 5. Are you generating an unmapped system? [Y/N]: n 

>* 6. Use an input saved answer file? [Y/N]: n 

>* 8. Do you want a Standard Function System? [Y/N]: y 


; Standard Function System - Phase I SYSGEN 
>* 9. Name of output saved answer file [D: SYSSAVED.CMD] [S]: 3) 

; Phase I output saved answers created in file DUO: (200, 200]SYSSAVED.CMD;1 
>* 15. Chain to Phase II after Phase I completes? [Y/N]: y © 

; Target configuration 


>* 1. Processor Type [D: 11/34] [SJ]: 11/23 

>* 2. Does processor have a switch register? [Y/N D:N]: 

>* 3. Memory size (in K-word blocks) [D R:16.-1920. D:16.]: 128. 
>* 6. Floating point processor (FP-11) present? [Y/N D:N]: 

>* 7. Floating instruction set (FIS) present? [Y/N D:N]: 

>* 8. Extended instruction set (EIS) present? [Y/N D:N]: y 

>* 10. Line frequency: A- 60 Hz B- 50 Hz [D: A] [S]: 

>* 11. KW11-Y Watchdog timer support? [Y/N D:N]: 

>* 12. Memory parity support? [Y/N D:N]: y 


; The response to the following question specifies the highest interrupt 

# vector. If you respond with a value less than or equal to 400, SYSGEN 

; will assign the value associated with the highest interrupt vector 

; specified during the Peripheral Section. Therefore, if your system 

3; will include devices that are not specified during the Peripheral 

: Section and which have vectors above 400 (devices such as K-series and. 
>; certain communication devices), specify that value in the next question. 


>* 14. Highest interrupt vector [O R:0-774 D:0]: 


>; For device configuration: "*" Prints device table, "." Terminates inquiry 
; "2" Prints current configuration 
(6) 
; Enter devices and number of controllers for devices which require drivers 
>* 15. Devices [S]: * © 
>; 
. Device codes for A/D and industrial/laboratory devices: 


>; AD- ADO1-D A/D Converter 
>; AF- AFC11 A/D Converter 

; AR- AR11 Laboratory Subsystem 
>; IC- ICR11/ICS11 Industrial Control Subsystem 
>; IS- DRS11/DSS11 Industrial Control Subsystem 
>; LA- LPA11 Laboratory Subsystem 
>; LS- LPS11 Laboratory Subsystem 

; UD- UDC11l Universal Digital Controller 


>; Device codes for Interprocessor communication devices: 
>; XB- DA11-B Interprocessor Link 


>; XE- DEUNA Unibus Ethernet Controller 
>; XL- DL11-E Interprocessor Link 
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XM- 
XP- 
XQ- 
XU- 
XW- 


DMC11-E/DMR11 Interprocessor Link 
DP11 Synchronous Interface 

DQ11 Synchronous Interface 

DUL1 Synchronous Interface 

DUP11 Synchronous Interface 


Device codes for unit record devices: 


CR- 
GR- 
LP- 
PP- 
PR- 


CR11/CM11-E Card Reader 

VT1l1/vS60 Graphics Subsystem 
LA11/LP11/LS11/LV11/LNO01 Line Printer 
PCll Paper Tape Punch 

PC11/PR11 Paper Tape Punch and Reader 


Device codes for disk devices: 


DB- 
DD- 
DF- 
DK- 
DL- 
DM- 
DP- 
DR- 
DS- 
DT- 
DU- 
DX- 
DY- 
EM- 


RP04/RP05/RP06 Disk Drive 

TU58 Cartridge DECtape II 

RF11l Fixed Head Disk Drive 
RKO03/RKO5 Disk Drive 

RLO1L/RLO2 Disk Drive 

RKO6/RKO0O7 Disk Drive 

RPO02/RP03 Disk Drive 
RM02/RM03/RM05/RM80 Disk Drive 
RSO03/RS04 Fixed Head Disk Drive 
TU56 DECtape 
RA60/RA80/RA81/RC25/RD51/RD52/RD53/RX50 Disk Drive 
RX0l Floppy Disk Drive 

RX02 Floppy Disk 

ML11 Non-Rotating Electronic Memory 


Device codes for Magnetic tape devices: 


CT- 
MM- 
MS- 
MT- 
MU- 


YH- 
YvV- 
YJ- 
YL- 
YZ- 


co- 
NL- 


15. 


TU60 Cassette Tape Drive 
TU16/TU45/TU77/TE16 Magtape Drive 
TS11/TU80/TSVO5 Magtape Drive 
TU10/TE10/TSO3 Magtape Drive 

TK50 Magtape Drive 


Device codes for terminal interface devices: 


DH11 Asynchronous Terminal Interface 

DHU11/DHV11 Asynchronous Terminal Interface 

DJ11 Asynchronous Terminal Interface 
DL11-A/-B/-C/-D/-E/-J/-W Asynchronous Terminal Interface 
DZ11/DZV11 Asynchronous Terminal Interface 


Device codes for pseudo devices: 


console device 
null device 


Enter responses as: devl=number controllers,dev2=number controllers, 
If a device is specified without the number of controllers, the number 


of controllers defaults to l. 


Example: DK,DM=2,YL,NL. 


Devices [S]: dl,du,mu,1p,yl=2,yz. @ 


Processor:11/23 Memory Size:128K,Mapped System:RSX-11M 


Extended Instruction Set 
Parity Memory 
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Host configuration 


1. Is a line printer available? [Y/N]: y 

3. Does the listing/map device have at least 120 columns? [Y/N]: y 
4. Assembly listings device (ddu:) [D: "NL:"] [S]: sy: 

5. Map device for Executive and device drivers (ddu:) [D: SY0:] [S]: 


Executive Options 
Cancel selective marktime support will be included 
Answer Y(ES) if the following support is desired 
30. Executive Debugging Tool (XDT)? [Y/N]: y 
32. Include support for communications products (such as DECnet)? [Y/N]: 
Checkpointing support will be included 
53. Enter CDA memory dump device mnemonic (ddu:) [S R:3-4]: mu0: 
54. Enter CDA memory dump device CSR [0 R:160000-177700 D:174500]: 
56. RT-11 emulation support? [Y/N]: n 
Terminal driver options 
The Full Duplex Terminal Driver will be included. 
System Options 
Answer Y(ES) if the following support is desired 
2A. Include support for the IP11 Industrial I/O Subsystem? [Y/N]: n 
11. What name would you like to give your system [D: RSX11M]} [S R:0-6]: 
12. Do you want SPM-11 support? [Y/N]: n 


Thinking ... 
End of Executive option generation at 13:49:32 on 12-JUN-85 


Peripheral configuration 


Parameters appearing in. square brackets "[...]" can only be 
specified for the first controller of a particular device. 
Parameters appearing in parentheses "(...)" only need be specified 
if the indicated option is present on the target system. 


The default for loadable drivers has been set to *TRUE*,. 
To override this setting enter R (resident) as the first parameter 
for the first controller of the specified device. 


.A/D and Laboratory devices: None specified 


Interprocessor communication devices: None specified 
Unit record devices: LP 


Enter [L/R,] vector, CSR, printer option 
(,[KMC timeout count <0=no KMC>, KMC vector, KMC CSR]) for: 


16. LP controller 0 [D: 200,177514,LA180,0,300,160130] [S]: @ 
Disks: DL, DU 


Enter [L/R,] vector, CSR, number of drives for: 


3. DL controller 0 [D: 160,174400] - (SJ: ,,1 0 
53. Contr 0 unit 0. is an RLO1/RLO2 [D: RLO1) [S}: r102 
3. DU controller 0 [D: 154,172150] {S]: ,,3 


4-100 
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; Tapes: MU 


>; Enter [L/R,] vector, CSR for: 


+ 1. MU controller 0 [D: 260,174500] {S]: 

¢ Non-physical (pseudo) devices: CO, TI, CL, ULB, SY 

¢ Terminal interface devices: YL, YZ 

3 Enter vector, CSR, E=DL11-E modem support/NO=no for: 

> 21. YL controller 0 [D: 60,177560,NO] [S}: 

>* 21. YL controller 1 [D: ,,NO] {S}: 300,176500 


>; Enter vector, CSR, highest line number <0 to 7> {, answer speed] for: 


>* 24. YZ controller 0 [D: ,160100,,300] {S}: 310,,3 
; 

>; 
; End of interrupt vector area has been set to 400 

>; 


>; Create Executive build files 


>* 1. Do you wish to edit any of the Executive files? [Y/N]: N 


; Prepare for task building 


>; Clean-up extraneous object files 


>; 
; End of SYSGEN phase I at 15:14:56 on 12-JUN-85 
3 -- Chaining to [200,200]SYSGEN2.CMD 
’ 
>@SYSGEN © 
7 
’ 
>; 
3 RSX-11M V4.2 BL38 System Generation PHASE I -- Version 2.10 
>3 


3 13-JUN-85 16:29:37 
: Big disk distribution kit 


>* 3. Do you want to inhibit execution of MCR commands (PREPGEN)? [Y/N]: 
>* 4, Have you made a copy of the distribution kit? [Y/N]: Y 

>* 5. Are you generating an unmapped system? [Y/N]: 

>* 6. Use an input saved answer file? [Y/N]: Y 

>* 7. Name of input saved answer file [D: SYSSAVED.CMD] [S]: 


3; Phase I input saved answers 

$ created on 12-JUN-85 at 14:52:56 
>; by SYSGEN version 2.10 
>; are from file DUO: [200,200]SYSSAVED.CMD;1 


3 

>* 9. Name of output saved answer file [D: DUO: [200,200]SYSSAVED.CMD] [S): 
>3 : 

>; Phase I output saved answers created in file DUO: [200,200]SYSSAVED.CMD;2 
>; 


>* 10. Use saved host configuration? [Y/N]: Y 
>* 11. Use saved peripheral configuration? [Y/N]: Y 
>* 12. Skip end of section (EOS) breakpoints? [Y/N]: Y 
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>* 13. Skip end of execution (EOX) breakpoints? [Y/N]: Y 

>* 14. Clean up files from previous GENS? [Y/N]: Y 

>* 15. Chain to Phase II after Phase I completes? [Y/N]: Y 

>SET /UIC=[1,1] 

>PIP {1,20]RSXBLD.CMD;*/DE/NM 

>PIP [{1,24]RSXBLD.CMD;*/DE/NM, TTDRVBLD; * 

>PIP [1,50]SYSVMR.CMD;*/DE/NM, [1,54] SYSVMR;* 

>PIP [11,20]*.OBJ;*/DE/NM,*.UDC;*,*.ICR;*,*.IDS;* ,*.PCS;* 

>PIP [11,24]*.OBJ;*/DE/NM,* .UDC;*,* .ICR;*,* .IDS;*,* .TTY;*,* .~PCS;* 
>PIP [11,30]*.LST;*/DE/NM, ([11,34]*.LST;* 

>PIP [11,10]RSXMC.MAC;*/DE/NM, ICTAB;*,[200, 200] SGNPARM.CMD; * 

>PIP [200,200] RSXBLD.CMD; */DE/NM, TTDRVBLD; * 

>PIP SY: [{11,20]RSXASM.CMD; */DE/NM, RSXDRVASM;*,[12, 20]MCRSETASM ;* 
>PIP SY: [11,24] RSXASM.CMD;* /DE/NM, RSXDRVASM;* , [12,20]MCRSETASM; * 
>PIP Gag Ce ee Ger aie EE ee Pat nen 
>PIP /FR 


DUO: has 199226. blocks free, 37986. blocks used out of 237212. 
Largest contiguous space = 114488. blocks 

6962. file headers are free, 1137. headers used out of 8099. 
>SET /UIC=[11,10] 

>; Target configuration 


; Processor:11/23 Memory Size:128K,Mapped System:RSX-11M 


f Extended Instruction Set 
; Parity Memory 


; Host configuration 
3; Executive Options 
>; Checkpointing support will be included 
; Terminal driver options 
s The Full Duplex Terminal Driver will be inlcuded. 
>; System Options 
>} Thinking ... 
3 End of Executive option generation at 16:31:03 on 13-JUN-85 


>; Peripheral configuration 


; Parameters appearing in square brackets “f{...J]" can only be 

; specified for the first controller of a particular device. 
>; Parameters appearing in parentheses "(...)" only need be specified 
>; if the indicated option is present on the target system. 
>; 

: The default for loadable drivers has been set to *TRUE*, 
>; To override this setting enter R (resident) as the first parameter 

Hy for the first controller of the specified device. 


>; A/D and Laboratory devices: None specified 
; Interprocessor communication devices: None specified 
>; Unit record devices: LP | 

; Disks: DL, DU 


>; Tapes: MU 
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>; Non-physical (pseudo) devices: CO, TI, CL, LB, SY 
; Terminal interface devices: YL, YZ 


>SET /UIC=[1,24] ! Creating TTDRVBLD.CMD 
>SET /UIC=[11,10] 
; End of interrupt vector area has been set to 400 


+ Create Executive build files @ 


>; 

>PIP RSXMC.MAC=SY0:RSXMCO.MAC/AP 

>ASN SY:=LB: 

>; 

>; Start of Executive assembly at 16:34:21 on 13-JUN-85 
>SET /UIC=[11, 24] 

>MAC @SY:RSXASM 


; End of.Executive assembly at 17:27:53 on 13-JUN-85 


; Start of MCR (subset) assembly at 17:27:53 on 13-JUN-85 
>SET /UIC=[12,24] 
>PIP *.OBJ;*/DE/NM 
>MAC @SY:MCRSETASM 


; End of MCR (subset) assembly at 17:36:40 on 13-JUN-85 


c 
>; Start of device drivers assembly at 17:36:40 on 13-JUN-85 
>SET /UIC=[11, 24] 
>MAC @SY:RSXDRVASM 
>; 
>; End of device drivers assembly at 18:23:19 on 13-JUN-85 
>ASN =LB: 


; Prepare for task building 


fA 
>SET /UIC=[1, 24] 
>PIP RSX11M.OBS=([11,24]*.OBJ 
>PIP TTDRV. OBJ=[11, 24] *.TTY 
>LBR RSX11M/CR:100.:1010.:128.=RSX11M.0BS 
>LBR TTDRV/CR: 30. :380.:64.=TTDRV 
>PIP [1,24]MCR.OBJ/NV/NM=[12,24]*.OBJ 
>PIP [12,24]*.OBJ;*/DE/NM 
>PIP /NV=[11,10]RSXBLD.CMD 
>PIP [11,10]RSXBLD.CMD; */DE/NM 


s Clean-up extraneous object files 


v 
>PIP RSX11M.0BS;*/DE/NM, TTDRV.OBJ;*,[11,24]*.OBJ;*,* .TTY;* 
>3 
>; End of SYSGEN phase I at 18:26:40 on 13-JUN-85 
>; -- Chaining to [200,200]SYSGEN2.CMD 
>7) 
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Notes for the terminal output from SYSGEN Phase I (for a mapped target 
system while running on a baseline system:- 


1) Invoke SYSGEN and begin answering Phase I questions. 


2) Answer Yes if you to want to do a PREPGEN first. 


3) In this example, pressing the RETURN key as the response to 
Question 9 selects the default output saved answer file named 
SYSSAVED.CMD. 


4) Answer Yes if you want to chain from Phase I to Phase II (If 


you decide to chain, SYSGEN automatically proceeds to Phase 
II from Phase I)... 


5) When you enter an asterisk (*) as a response to Question 15 
in the Target Configuration Section, SYSGEN displays a table 
of RSX-11M devices. 


6) Select the devices and the number of device controllers’ for 
your target system. You can display the current system 
configuration by entering a question mark (?) before 
terminating your input with a period (.). 


If you make several corrections while specifying the devices 
for your target system, entering the question mark shows you 
the current status of your input. This feature can help you 
avoid making errors in your final response. 


7) In the Peripheral Options Section, SYSGEN displays a comment 
line before each question for each selected device. The 
comment line contains the various fields that specify the 
type and order of the information for you to input. (See 
Section 3.3 for more information.) 


© This is an example of how you can include default values in 
your response to Peripheral Options questions. The commas 
(,,) indicate that the default vector and CSR addresses were 
selected for the DL controller. 


9) When the PREPGEN finishes and you are ready to perform your 
SYSGEN, invoke SYSGEN Phase I again and use the saved answer 
file created by the PREPGEN. 


10) After all Phase I questions have been answered, SYSGEN 
creates the prefix file RSXMC.MAC. SYSGEN uses RSXMC.MAC in 
the Executive and device driver assemblies. 


The remainder of Phase I involves the assembly of the Executive, a 
subset of MCR, and device drivers. Depending on the host system 
processor and the options you selected, this process takes from one to 
two hours. This is your opportunity to take a break. If you directed 
SYSGEN to pause at EOX breakpoints, you should check back every half 
hour or so to answer EOX breakpoint questions at the end of the 
assemblies. 
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DETAILS OF SYSGEN PHASE II 


Phase II is the task-building phase of the system generation 
procedure. During Phase II, SYSGEN task builds the Executive and any 
resident device drivers. It also creates the system image file 
RSX11M.SYS and task builds loadable device drivers and privileged 
tasks such as MCR. Example 5-1 (at the end of this. chapter) is an 
annotated terminal output from SYSGEN Phase II. 


During this phase, SYSGEN creates’ the indirect command file 
SYSVMR.CMD. This file contains Virtual Monitor Console Routine (VMR) 
commands that, upon execution, create partitions, load device drivers, 
and install tasks in the system image file RSX11M.SYS. Toward the end 
of Phase II, SYSGEN allows you to edit SYSVMR.CMD to modify partition 
base addresses, install additional tasks, or make other changes. 
Then, if you are running SYSGEN on a stand-alone system, SYSGEN 
invokes SYSVMR.CMD. 


If you are generating your system from an on-line host system, you 
should note the following two items. First, SYSGEN does not invoke 
VMR. You have to invoke VMR after SYSGEN completes Phase II. (See 
Section 5.6.1.) Second, SYSGEN always invokes the Version 4.2 Task 
Builder (TKB) to task build its files. The Version 4.2 fTKB is 
installed as task ...TKL. This permits you to still use the current 
system's TKB while the on-line SYSGEN is in progress. 


SYSGEN uses the following files as input to Phase II: . 


RSXBLD.CMD This file is the Executive build file. It directs the 
Task Builder in constructing the user-tailored 
Executive and the resident device drivers. This file 
also task builds the loadable task loader and the 
Executive commons if you selected either option during 
Phase I. SYSGEN creates RSXBLD.CMD during Phase I 
(based on your responses). 


RSX11M.OLB This file is the Executive object library file. It 
contains the Executive modules, standard driver 
modules, and any user-written drivers. SYSGEN uses 
this library to task build the Executive (including 
any resident drivers) and any loadable drivers. 


SGNPARM.CMD This is a parameter file containing Indirect symbol 
definitions. SYSGEN creates SGNPARM.CMD during Phase 
I based on your responses to the questions. 
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TTDRVBLD.CMD This file directs the Task Builder in constructing the 
full-duplex terminal driver. SYSGEN uses TTDRV.OLB as 
input from Phase I to construct the object library for 
the full-duplex terminal driver. 


However, SYSGEN inputs these files to Phase II only if 
you selected the full-duplex terminal driver in Phase 
I. If you specified a resident half-duplex terminal 
driver, SYSGEN treats it as any other resident driver 
in RSXBLD.CMD. If you specified a loadable 
half-duplex terminal driver, SYSGEN creates’ the 
necessary task-build file during Phase II. 


Phase II, like Phase I, is organized into logical sections. However, 
not all of the sections for Phase II require that you answer questions 
(except for EOX breakpoints). For some sections, like the System 
Image Creation Section, the processing does not require user input. 
The section headings appear on your terminal, however, to show the 
distinct logical parts of SYSGEN Phase II. They also serve to allow 
you to see how far processing has progressed. The section headings 
for Phase II follow below. Those sections not requiring user input 
are enclosed in parentheses and are not discussed. 

@e Setup Section 

e (Library Build Section) 

e Executive Task-Build Section 

e (System Image Creation Section) 

e (Full-Duplex Terminal Driver Task-Build Section) 

e Loadable Driver Task-Build Section 


@® Common Block Task-Build Section 


e Privileged Task-Build Section 


(System VMR Section) 


5.1 PREPARING FOR PHASE II 


Before beginning Phase II of SYSGEN, make sure you have done the 
following: 


e If you generate your system from an on-line Version 4.2 host 
system, set your directory to be [200,200], assign the pseudo 
device name SY: . to your baseline disk, and invoke SYSGEN2.CMD 
as follows: 


>SET /UIC=[200, 200] | 
>ASN ddu:=SY: @ED (where ddu: is the baseline disk, RSXM38) 


>MOU ddu:RSXM38 
> @SYSGEN2 


e If you generate your system from a stand-alone host system, 
bootstrap the baseline system (see Section 4.1) and then 
invoke SYSGEN2.CMD as follows: 


> @SYSGEN2 QED 
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Figure 5-1 shows the processing steps that take place during SYSGEN 
Phase II. 
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Figure 5-1 
Logical Flow of SYSGEN Phase II 
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5.2 SETUP SECTION 
* 1. In what UIC is SGNPARM.CMD if not <uic> ? [S]: 


Enter the directory containing the file SGNPARM.CMD. SYSGEN' replaces 
<uic> with the directory from which you invoked Phase II of SYSGEN. 
SYSGEN creates SGNPARM.CMD during Phase I in the same directory from 
which you invoked Phase I. Enter a different directory to override 
this default; otherwise, press the RETURN key. If you followed the 
instructions in Section 4.1, your directory is [200,200]. 


SGNPARM.CMD supplies Indirect symbol definitions from Phase I that are 
relevant to Phase II processing, and provides a means of communicating 
between Phase I and the other phases of SYSGEN. SYSGEN creates this 
file in the directory corresponding to the directory from which you 
invoked Phase I of SYSGEN. 


If you are chaining to Phase II, the response to this question 


defaults to the directory from which you invoked Phase I and this 
question does not appear. 


* 2. Do you want to inhibit execution of MCR commands (PREPGEN)? [Y/N]: 


This option allows you to perform the logical SYSGEN procedure and 
create a saved answer file that you can use as input to SYSGEN later 
when you actually generate your system. 


If you respond Yes to this option, SYSGEN displays the questions and 
creates a saved answer file of your responses. However, SYSGEN does 
not process any MCR commands (such as PIP and fTKB) as it normally 
would and, therefore, does not create your system. 
When you perform a PREPGEN in Phase T1y SYSGEN: 

e Does not make logical device assignments 

e Does not task build files 

e Does not task build libraries 

e Does not create privileged task-build .CMD or .ODL files 

e Does not create loadable driver task-build .CMD files 

e Does not create SYSVMR.CMD 

@ Does not invoke an editor for modifying files 
When you perform a PREPGEN, SYSGEN does create a saved answer file. 
If you respond Yes and if you are using an RLO1/RLO2 distribution kit, 
SYSGEN will mount the build files disk after you enter the drive 
containing the disk (Question 7). The build files disk in the 


RLO1L/RLO2 kit is  PRVBLD. See Question 2A in the Setup Section of 
Phase I for more information. 
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If you respond No to this question, SYSGEN executes all MCR commands 
and generates an RSX-11M system. 


If you are chaining to Phase II, the response to this question 
defaults to the response given for Question 3 in the Setup Section for 
Phase I. In this case, the question does not appear. 


* 2A. Do you want to create the build files on the SY: device? [Y/N D:Y] 


This question appears only if you answered Yes to Question 2 (Inhibit 


MCR commands), you are not chaining from Phase I to Phase II, and you 
are using the RLOI1/RLO2 distribution kit. 


Your answer determines where SYSGEN will create the task-build files. 
If you answer Yes or take the default, the files are created on SY:. 
If you answer No, the files are created on NL:. 


Creating the files on one of these pseudo devices helps recover space 
on the RSXM38 and PRVBLD disks. 


* 3. Use an input saved answer file? [Y/N]: 


If you have previously created a saved answer file, this option lets 

you direct SYSGEN to use that file as input responses to the Phase II 

questions. Any SYSGEN question that is automatically answered by a 

saved answer file does not appear on your terminal. SYSGEN does not 
save responses to questions concerning the task-building of LPA 

initialization code. 


Enter a response of Yes to this question if you intend to use a_ saved 
answer file for input. If you selected the Standard Function System 
(see Section 3.6.2) and did not direct SYSGEN to chain directly to 
Phase II (Question 16 in the Phase I Setup Section), respond Yes to 
this question. If you are using an input saved answer file, SYSGEN 
asks for the name of that file in Question 4. 


If you directed SYSGEN to chain directly to Phase II, the default 
response to this question is the same as the response given for 
Question 6 in the Phase I Setup Section. In this case, the question 
does not appear. 


* 4. Name of input saved answer file [D: <default> ]: 


SYSGEN displays this question only if you responded Yes to Question 3. 
If the saved answer file used as input for Phase I exists, SYSGEN uses 
that file name as the default response for this question. If you 
selected the Standard Function System in Phase I, the default input 
saved answer file is SGNSTAND.CMD. Otherwise, there is no default 
response. 


If you have previously created a saved answer file having a file “name 


different from the default response, you may enter the name of that 
file. 
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If the specified file does not exist, SYSGEN repeats Question 3. 


If you enter a response other than the default and omit a file type, 
SYSGEN assumes the file type .CMD. 


If you are chaining to Phase II, the response to this question 
defaults to the response given for Question 7 in the Setup Section in 
Phase I. In this case, the question does not appear. 


* 5. Name of output saved answer file [D: <default>] : 


SYSGEN saves your responses to Phase II questions in an output saved 
answer file. This question allows you to name that file. 


The default name of the output saved answer file is the same as_ the 
response given for Question 9 of the Setup Section in Phase lI. 


Likewise, if you are chaining to Phase II, the response to this 
question defaults to the response given for Question 9 in the Setup 
Section of Phase I. In these cases, the question does not appear. 


If the name of the output saved answer file for Phase II is the same 


as the name of the output saved answer file from Phase I, SYSGEN does 
not create a new output saved answer file, but it appends your Phase 
II responses to the existing saved answer file. 


If you enter a response other than the default and omit a file type, 
SYSGEN assumes the file type .CMD. 


* 6. Skip end-of-execution (EOX) breakpoints? [Y/N]: 


End-of-execution (EOX) breakpoints occur after every section in Phase 
II except for the system VMR section. 


When SYSGEN stops at EOX breakpoints, you can verify that no errors 
have occurred during the preceding operation. If you are confident 
that no errors will occur during execution, answer Yes to this 
question. SYSGEN proceeds directly to subsequent sections without 
stopping. 


This question appears only if you are doing an actual SYSGEN (for 
example, you answered No to Question 3 in Phase I) and if you 
specified that you are using an input saved answer file (for example, 
you answered Yes to Question 7 in Phase I). 


If you are chaining to Phase II and did not direct SYSGEN to inhibit 
MCR commands, the response to this question defaults to the response 


given for Question 13 in the Setup Section of Phase I. In this case, 
the question does not appear. 
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* 7. Enter device for PRVBLD disk when it is ready (ddu:) [D: DL1l:] [S] 


To answer this question, enter the device type and unit number  (ddu:) 
of the drive on which the PRVBLD disk should be mounted. The default 
response is the drive specified in response to Question 17 in the 
Phase I Setup Section. 


This question appears only if you are using an RLO1/RLO2 distribution 


kit and if you are not chaining from Phase I. SYSGEN mounts the 
PRVBLD disk on the device you specify. 


If you are chaining to Phase II from Phase I, this question does not 
appear, and SYSGEN will mount the PRVBLD disk on the device that you 
specified in response to Question 17 of the Phase I Setup Section. 


SYSGEN always dismounts the PRVBLD disk at the end of Phase II. 
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5.3 EXECUTIVE TASK-BUILD SECTION 
* 1. List Executive map? [Y/N]: 


The Executive map lists the Executive global symbols and their 
locations in memory. These locations are used to lay out partitions. 
If you are generating a mapped system, the map is probably not 
necessary. If you are generating an unmapped system, the map is 
necessary for you to know where to start setting up your system 
partitions. 


If you respond Yes, SYSGEN prints or spools the map on the line 
printer (if the system includes one) or terminal. 


If you are generating an unmapped system, you must establish the 
locations for the system partitions. Look at the Executive map for 
the symbol SSYTOP. The value of SSYTOP indicates the last address 
allocated to the Executive. Partitions may start on any 32(10)-word 
boundary beyond this address. 


Following the Executive task build, SYSGEN displays a table (on the 
terminal) that contains information on the default size and base 
address of the system partitions. The information in this’ table, 
together with the value of SSYTOP, may assist you in establishing 
partitions. 


SYSGEN calculates the partition base addresses on the assumption that 
SSYTOP does not exceed 40000(8). You can specify a base address other 
than the default base address in the Privileged Task-Build Section. ~ 


NOTE 


SYSGEN lists RSX11M.MAP only. If you selected the 
Executive commons, SYSGEN does not list the Executive 
commons maps (EXCOM1.MAP and EXCOM2.MAP) and_ the 
loadable task loader map (LDR.MAP). 
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5.4 LOADABLE DRIVER TASK-BUILD SECTION 


This section provides details for SYSGEN processing of loadable driver 
task-build command files. 


The file SGNBLDDRV.CMD controls the task-building of loadable drivers 
and also permits incorporation of loadable user-written drivers. 


SYSGEN invokes this command file during Phase II when your’ system 
includes loadable drivers or if you specified that you want to include 
a user-written driver. Note that SGNBLDDRV.CMD can be _ invoked 
directly from MCR (outside SYSGEN) to aid in task building (or re-task 
building) drivers. 


If you invoke SGNBLDDRV.CMD outside of SYSGEN, you must answer 


Questions 1, 2, and 3. If SYSGEN invokes SGNBLDDRV.CMD, these first 
three questions do not appear. 


* 1. In what UIC is SGNPARM.CMD if not <uic> ? [S]: 


Enter the directory containing the file SGNPARM.CMD. SYSGEN' replaces 
<uic> with the directory from which you invoked SGNBLDDRV.CMD. Enter 
a different directory to override this default; otherwise, press’ the 
RETURN key. 


SGNPARM.CMD supplies Indirect symbol definitions from Phase I that are 
relevant to Phase II processing, and provides a means of communicating 
between Phase I and the other phases of SYSGEN. SYSGEN creates this 
file in the directory corresponding to the directory from which you 
invoked Phase I of SYSGEN. 


* 2. Enter device for <label> disk when it is ready (ddu:) [D: <default>] [S]: 


To answer this question, enter the device mnemonic and unit number of 
the drive containing the PRVBLD disk. (SYSGEN replaces <label> with 
the volume name of the appropriate disk.) 


This question appears only if you are using an RLOL/RLO2 distribution 
kit. SYSGEN replaces <label> with PRVBLD. 


The default response (<default>) is the response entered for Question 
16 (the Executive source disk) of the Setup Section in Phase I. 


* 3. Enter map device (ddu:) [D: NL:]: 


Map listings are usually of little use if your target system is 
mapped. The map listings are more useful if your target system is 
unmapped and you need to determine the size of your tasks. 


If you want the maps, specify the desired output device as your 
response. If you specify a device other than LP:, SY:, LB:, TI:, TT:, 
or NL:, the device must be mounted (using the MCR MOUNT command), and 
the directory [1,34] for mapped systems or [1,30] for unmapped systems 
must exist on the volume. 


The default output device for the task maps is NL: (the null device). 
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* 4. Build all selected loadable drivers into DRVPAR? [Y/N]: 


This question appears for mapped systems only. Normally, all loadable 
drivers in a mapped system are built to run in partition DRVPAR. 


If you enter Yes, SYSGEN builds all the loadable drivers you selected 
in Phase I for partition DRVPAR. . 


If you enter No, SYSGEN prompts for the drivers you want to build by 
asking Question 5 of this section. 


* 5. Driver 2-character device mnemonic [S]: 


To answer this question, enter a two-character device mnemonic for any 
loadable driver (including user-written drivers) you want to build. 
Enter only one device mnemonic each time this question appears. After 
each response to this question, SYSGEN asks Question 6. Answer 
Question 6 by entering the partition name into which you wish to build 
each driver. If your target system is unmapped, SYSGEN also asks for 
the base address of each partition name in Question 7. 


This sequence of two or three questions (three if your target system 
is unmapped) appears for each loadable driver you want to build. When 
you have entered all the driver names you intend to include in your 
target system (and the appropriate partition information), press the 
RETURN key the next time Question 5 appears. SYSGEN then proceeds to 
the Privileged Task-Build Section if SGNBLDDRV.CMD was invoked during 
SYSGEN Phase II. If SGNBLDDRV.CMD was invoked outside SYSGEN, it 
exits at this point. 


If you are generating an unmapped system, you should successively task 
build each of the loadable drivers twice. For example, in the first 
pass, you might task build the DB, DK, DL, and TT drivers. In the 
second pass, task build them again. 


In the first pass, task build the drivers using a temporary base 
address for the driver partition (see Question 7). The temporary 
partition base address should be less than 28K and should begin on a 
32(10)-word boundary. 


After all the drivers are successfully built the first time (up 
through Question 7), exit from Phase II. 


For the second pass, invoke Phase II again to look at the driver maps 
(Question 3) to determine the size (length) of each driver and then to 
task build them again. When you reinvoke Phase II, you should not use 
an input saved answer file (Setup Section, Question 3). 


You can determine the size of a driver by locating the line "Task 
address limits:" on the driver map and subtracting the first number in 
the line from the second number in the line. Then round the result up 
to the nearest 64(10) or 100(8) number. 
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Using the size of each loadable driver, with information in your 
terminal output that follows the Executive task build, you can 
establish the placement of each loadable driver partition. Once you 
have made these calculations, begin your second pass at task building 
the same drivers using the correct partition base address. 


NOTE 


TT is the mnemonic of the terminal interfaces (YH, YJ, 
YL, YV, and YZ). 


If you selected the full-duplex terminal driver in Phase I, the 
full-duplex terminal driver has been task built already. Do not enter 
the full-duplex terminal driver as part of your response to this 
question. 


This question appears if your target system is unmapped, if you have a 
mapped target system in which all drivers are not to be built for 
DRVPAR (that is, if you answered No to Question 4 in this section), or 
if your target system includes any loadable user-written drivers. 


* 6. Driver partition name [D: <dev>PAR] [S]: 


The default partition for mapped systems is DRVPAR. 


The default partition for unmapped systems is <dev>PAR, where <dev> is 
the two-character device mnemonic specified in Question 5. 


For unmapped systems, consider building the system disk driver for the 
partition that corresponds to the two-character device mnemonic (for 
example, DBPAR for RP04/RP05/RP06). This is also recommended for 
other drivers that should run in their own partition (for example, 
TTPAR). A suggested partition name for less frequently used drivers 
is DRVPAR. You can load a driver as you need it (after unloading the 
driver that currently occupies the DRVPAR partition). 


* 7. <dev>PAR's partition base address in 32-word blocks [S]: 


This question appears for unmapped systems only. 
Enter the base address of the specified partition. 
The base address is required during the dynamic creation of the driver 


task-build command files. The base address of the partition must 
start on a 32(10)-word boundary. 
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5.5 PRIVILEGED TASK-BUILD SECTION 
* 1. Map device for privileged tasks (ddu:) [D:NL:] 


Usually, these maps are of little use if your target system is mapped. 
The default response directs the maps to the null device. The maps 
are more useful if your target system is unmapped and you need to 
determine the exact size of the tasks. 


If you want the maps, enter a device specification. Note that if you 
enter other than LP:, SY:, LB:, TI:, TT:, or NL:, the device must be 
mounted (using the MCR MOUNT command), and the directory [1,30] for 
unmapped systems or [1,34] for mapped systems must exist on the 
volume. 


* 2. GEN'sS base address in 32-word blocks [0 D:400]: 


This question appears only for unmapped systems. 


The partition base address of GEN is necessary during the dynamic 
creation of task-build .CMD files for those RSX-11M tasks built to run 
in GEN. SYSGEN uses GEN's partition base address in the dynamically 
created command file SYSVMR.CMD. 


The base address of GEN starts on a 32(10)-word boundary. 


The default of 400 is based on the assumption that the highest 
location in memory allocated to the Executive does not exceed 40000 
and that you intend to use the nonprivileged baseline tasks as they 


were built (that is, to run in the GEN partition starting at location 
40000). 


If you intend to include nonprivileged, DIGITAL-supplied RSX-11M tasks 
in your target system, you must task build those tasks during Phase 
III. 


* 3. SYSPAR's base address in 32-word blocks [0 D:<default>]: 


This question appears only for unmapped systems. 


The partition base address of SYSPAR is necessary during the dynamic 
creation of task-build .CMD files for those RSX-11M tasks built to run 
in SYSPAR. SYSGEN also uses SYSPAR's base address in the dynamically 
created command file SYSVMR.CMD. 


If the target system has 24K words or more of memory, the default 
(<default>) is 1300. This default is based on the assumption that you 
selected the default of 400 32(10)-word blocks for the GEN partition 
and that you plan to include a 14K task partition (PAR14K) of which 
GEN is an 8K subpartition. 
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If the target system has fewer than 24K words of memory, the default 
is 1000. This default is based on the assumption that you have 
selected the default of 400 32(10)-word blocks for the GEN partition 
and that GEN is an 8K partition. 


The base address of SYSPAR starts on a 32(10)-word boundary. 
* 4, SPLPAR's base address in 32-word blocks [0 D:1300] 


This question appears for unmapped systems only, and only if you 


selected the serial despooler (Question 7 in the System Options 
Section of Phase I). 


The partition base address of SPLPAR is necessary during the dynamic 
creation of PRTBLD.CMD. SYSGEN uses SPLPAR's base address in the 
dynamically created command file SYSVMR.CMD. 


The base address of SPLPAR starts on a 32(10)-word boundary. If you 
selected FCPMIN, the default response for this question can be 
calculated by adding 100 to the default base address of SYSPAR. 


If you selected FCPSML, the default response for this question can be 
calculated by adding 120 to the default of Question 3 above. 


* 5. Pause to edit any task build .CMD or .ODL files? [Y/N]: 


If you answer Yes to this question, SYSGEN pauses to allow you to 
selectively edit the task-build .CMD or .ODL files. This is the 
logical place in SYSGEN to alter any task-build parameters for tasks 
built during Phase II, if you need to do so. If you choose to edit 
any .CMD files, the information you require to edit a given file is 
contained in comments within that file. 


* 6. Delete task-build .CMD and .ODL files after task-building? [Y/N]: 


It is usually not necessary to keep the .CMD and .ODL files after they 
have been used to build their respective tasks. They can be easily 
re-created by reinvoking SYSGEN3.CMD. You can free the disk space 
occupied by these files by answering Yes to this question. 
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5.6 SYSTEM VMR SECTION 
* 1. Edit SYSVMR.CMD? [Y/N]: 


This question permits you to edit the SYSVMR.CMD file. 


SYSGEN defaults all. terminal lines to a 110 baud rate (unknown 
terminal type and lowercase input disabled). Even if modem support is 
included, all the lines are local and autobaud detection is disabled. 
These parameters can be changed to suit your particular configuration 
by answering Yes when SYSGEN asks if you want to edit SYSVMR.CMD. 


Include in SYSVMR the appropriate commands, such as SET 
/REMOTE=TT3:300 or SET /VT100=TT5:, as desired. This ensures that 
your terminal lines are set properly when the system is booted. These 
commands may be entered directly to VMR at any time after SYSGEN. 
They may also be entered to MCR. However, in that case, their action 
is lost the next time you bootstrap the system. 


NOTE 


VMR may output several diagnostic (*DIAG*) messages 
during its operation. Diagnostic messages may be 
ignored. (See Example 5-1 at the end of this chapter 
for sample messages.) 


SYSGEN Phase II creates the file SYSVMR.CMD to create the partition 
structure, install tasks and commons, and load loadable drivers. 
These actions prepare the system image file, created during Phase II, 
for actual execution. 


For mapped systems, it is not usually necessary to edit this file, 
although without editing, it may not produce an optimal system on 
small configurations. SYSVMR.CMD typically produces a valid mapped 
system image. Figure 5-2 depicts a mapped system partition structure 
that results from executing SYSVMR.CMD. 


For mapped systems, SYSVMR: 


e Extends pool space to the maximum size of the Executive 
(either 16K or 20K). If you do not want to use the maximum 
amount of pool, edit SYSVMR.CMD. Locate the line SET /POOL= * 
and change the asterisk (*) to the specific desired value. 
See the SET /POOL command in Chapter 10 of the RSX-11M/M-PLUS 
System Management Guide. 


e If you selected the loadable loader, creates the partition 
LDRPAR and installs and fixes the loader in it. 
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FCPPAR 
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SYSPAR 


DRVPAR 
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TTPAR 
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LDRPAR 

(optional) 
pee 


ZK-316-81 


Figure 5-2 
Partition Structure on Mapped Systems 


If you selected support for the Executive commons in Phase I, 
establishes them in the system image in the following 
sequence: 


1. A 4K partition called EXCOM1 is created. 


2. The first Executive common, EXCOM1.TSK, is installed in 
that partition. As the common is installed, the EXCOM1]1 
partition is automatically reduced in size to match the 
size of EXCOM1.TSK. 


3. A 4K partition called EXCOM2 is created. 


4. EXCOM2.TSK is installed in that partition. As the common 
is installed, EXCOM2 is automatically reduced in size to 
match the size of EXCOM2.TSK. 


If you selected the full-duplex terminal driver, creates 
partition TTPAR and loads the terminal driver into it. By 
default, SYSGEN sets the size of TTPAR to 8K words, but it can 
usually be made smaller. 


TTPAR contains ‘code plus a private buffer pool, which is 
allocated in 20-word(decimal) blocks for typeahead buffers, 
UCB extensions, and 1/0 buffers. Since the number of I/0 
buffers required depends upon both system activity and the 
length of the I/O requests, an exact sizing guideline cannot 
be given. However, a rough algorithm for determining the size 
of TTPAR is: 


P=cC + (20 * T) + (60 * A) 
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where: 

P is the size of TTPAR in decimal words 

Cc is the code size of the driver (from the line "TASK IMAGE 
SIZE" in [11,34]TTDRV.MAP) 

T is the number of terminals in the system 

A is the average number of I/0 requests pending at any 


given time 


e If you selected loadable drivers, creates partition DRVPAR and 
loads all loadable drivers built during Phase II into it. If 
you do not want to load all drivers, edit SYSVMR.CMD and 
delete the LOAD command for each driver you wish to exclude. 


NOTE 


SYSGEN uses wildcards (*) to create DRVPAR's 
size as the sum total of all drivers loaded 
during the execution of SYSVMR.CMD. If you 
wish to allow space for other drivers, edit 
the partition statement and specify sufficient 
space. (You need the driver maps to determine 
what size DRVPAR should be.) 


Rather than delete command lines that load 
drivers that you do not need, it is suggested 
that you insert a semicolon (7) at the 
beginning of the line. VMR treats such lines 
as comments. 


e Creates partition SYSPAR and, if you selected FCPMIN or 
FCPSML, installs the respective FCP into it. The length of 
SYSPAR is 10300(octal) bytes for a system with FCPMIN and 
12000(octal) bytes for a system with FCPSML. The length- of 
SYSPAR for nonmultiuser systems with full-duplex terminal 
driver support is 11700(octal) bytes. The length of SYSPAR 
for all other cases is 10100(octal) bytes. 


e If you selected an FCP other than FCPMIN or FCPSML, creates 
partition FCPPAR. 


@e Creates partition GEN (from the end of last partition to top 
of memory). . 


e Installs tasks built during Phase II. 


e If you selected direct access to device registers for ICS/ICR, 
UDC11l, or DSS/DRS devices, creates the respective device 
common, which overmaps the I/O page. 


For unmapped systems, it is not possible for SYSVMR.CMD to create an 
optimal partition structure. You must edit SYSVMR.CMD. Figure 5-3 
depicts an unmapped 16K to 24K system that results from executing 
SYSVMR.CMD. In an unmapped 16K to 24K system, the lack of adequate 
memory prevents SYSMVR.CMD from creating PAR14K (the partition used by 
MAC, TKB, and ICP). Note that for unmapped systems, SYSVMR does not 
create driver partitions. 
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Figure 5-3 
Partition Structure on Unmapped 16K through 24K Systems 


For unmapped 16K to 24K systems, SYSVMR: 


@e Creates partition GEN. The base address of GEN is the base 
address specified as your response to Question 2 of the 
Privileged Task-Build Section. The length of GEN is always 
40000(octal) bytes. 


e Creates partition SYSPAR. The base address of SYSPAR is the 
base acCdress specified as your response to Question 3 of the 
Privileged Task-Build Section. The length of SYSPAR is 
10000(octal) bytes for a system with FCPMIN and 12000 (octal) 
bytes for a system with FCPSML. 


e If you selected PRT, creates SPLPAR. The base address of 
SPLPAR is the base address specified as the response to 
Question 4 of the Privileged Task-Build Section. The length 
of SPLPAR is 10400 bytes. 


@e Installs tasks built during Phase II. 


e If you selected direct access to device registers for an 
ICS/ICR, UDCl1, or DSS/DRS device, creates the respective 
device common, which overmaps the I/0 page. 


Figure 5-4 depicts an unmapped 24K through 28K system that results 
from executing SYSVMR.CMD. Note that for unmapped systems, SYSVMR 
does not create driver partitions. 
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Figure 5-4 
Partition Structure on Unmapped 24K through 28K Systems 


For unmapped 24K through 28K systems, SYSVMR: 


e Creates partition PAR14K. The base address of GEN and PARI14K 
is the base address specified as your response to Question 2 
of the Privileged Task-Build Section. The length of GEN is 
always 40000 bytes. The length of PAR14K is always 70000 
bytes. 


® Creates partition SYSPAR. The base address of SYSPAR is’ the 
base address specified as your response to Question 3 of the 
Privileged Task-Build Section. The length of SYSPAR is 1000 
bytes for a system with FCPMIN and 1200 bytes for a system 
with FCPSML. 


e If you selected PRT, creates SPLPAR. The base address of 
SPLPAR is the base address specified as the response to 
Question 4 of the Privileged Task-Build Section. The length 
of SPLPAR is 10400 bytes. 


e Installs tasks built during Phase II. 


e If you selected direct access to device registers for an 
ICS/ICR, UDCll, or DSS/DRS device, creates the respective 
device common, which overmaps the I/O page. 


5.6.1 Invoking VMR from an On-line Host System 


If you are running SYSGEN on an on-line system, SYSGEN completes Phase 
II execution without invoking VMR (that is, SYSGEN does not invoke the 
command file SYSVMR.CMD). The reason for this is that you must use 
Version 4.2 of VMR. In an on-line environment, SYSGEN cannot tell 
which version of VMR is available on your on-line system. 
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Therefore, if you invoked SYSGEN on an on-line system, you must: 
1. Assign the logical device LB: to the baseline disk 


2. Set your directory to be the target directory (that is, 
[1,54] for mapped systems or [1,50] for unmapped systems) 


3. Install VMR Version 4.2 
4. Invoke VMR and use SYSVMR.CMD 


You may accomplish these steps by entering the following commands 
after Phase II completes execution: 


>ASN (ddu:)=LB: QED 
>SET /UIC=[1,54] GED 
>INS ddu: SVMR @E) 
>VMR @SYSVMR 


where ddu: is the device mnemonic of the baseline disk. 


5.6.2 Using VMR to Create Partitions for RMS-11 Libraries 


If you want to create the partitions for the RMS-11 resident library 
(or libraries) while you are in VMR, use VMR SET commands. The 
following VMR SET commands can be used as a guide, but you must 
replace the word "“base" with the octal address of the base of the 
partition and you must replace the word "size" with the size of the 
resident library. Sizes of the resident libraries can be determined 
from the .MAP files in directory [1,34] or from the sample VMR_ SET 
commands contained in [1,2]STARTUP.CMD. 


e Create the partition RMSRES. Note that the size of this 
partition depends on whether you intend to use the 
full-function RMSRES library or the subset library RMSRESSUB 
(which supports sequential and relative file organizations 
only). 


SET /MAIN=RMSRES:base:size:COM 


e If you want to use the RMSDAP resident library to access 
RMS-11 files on remote nodes, create the partition DAPRES. 


SET /MAIN=DAPRES:base:size:COM 
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Example 5-1: Annotated Terminal Output from SYSGEN Phase II 


c 
>; End of SYSGEN phase I at 15:14:56 on 12-JUN-85 © 
>; =-- Chaining to [200,200]SYSGEN2.CMD 


; RSX-11M V4.2 BL38 System Generation PHASE II -- Version 2.11 


; 12-JUN-85 15:14:56 


>; Big disk distribution kit SYSGEN version 2.10 for RSX-11M BL38 
>; Continuation from SYSGEN PHASE I done on 12-JUN-85 at 15:14:49 


>; SYSGEN assumes that the map disk is already mounted in SY0: with 
>; UFD [1,34]. 


>; Standard Function System - Phase II SYSGEN 
>; Phase II output saved answers created in file DUO: [200,200]SYSSAVED.CMD;1 
; Library build 


; Executive task build 
>* 1. List Executive map? [Y/N]: y 


>; System image creation 
; Full duplex terminal driver task build 


>; Loadable driver task build 
>* 4. Build all selected loadable drivers into DRVPAR? [Y/N]: yY 
>; Common block task build 


>; Build the ANSLIB flavor of the FCS resident library common 
>; Creating the task build .CMD and@ .ODL files in SY: [1,24] 
>; Privileged task build 


>; Note that the following tasks will be built for your system: 


>; BOO DMO FCPMDL ICP INI INS PMT 

; MCR DCL MOU QMG QMGCLI QMGPRT LPP 
>; F1l1MSG MTAACP SAV TKTN UFD LOA UNL 
>; PMD RMD SHF ACNT BYE HEL BRO 
>? SHUTUP ACS ERRLOG ELI RCT 


5-20 
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l. Map device for privileged tasks (ddu:) [D: NL:] [S]: SY: 
5. Pause to edit any task build .CMD or .ODL files? [Y/N]: N 
6. Delete task build .CMD and .ODL files after building? [Y/N]: N 


It is assumed that [1,1]FCSRES.STB is an ANSLIB version of the FCS 
resident library 


Creating the task build .CMD and .ODL files in SY: {1,24} 


System VMR 
1. Edit SYSVMR.CMD? [Y/N]: N 


An alternate version of SYSLIB.OLB, the system object library, was 
created to provide support for ANSI magtape/FCS big-buffering (which 
you selected in Phase I). You may want to rebuild DMP, FLX, PIP, and 
VFY in Phase III to use ANSLIB.OLB. Note, however, building tasks with 
ANSLIB.OLB causes an increase in the size of tasks as compared to the 
SYSLIB.OLB version of the tasks. 


A memory resident library of FCS routines (which you selected in Phase I) 
was built to help reduce task memory requirements. You may want to rebuild 
tasks in Phase III to link to the FCS resident library. 


When SYSGEN finishes, boot in your target system, and save the system with a 
bootstrap. For example: 


>BOO [1,54]RSX11M 
XDT: 38 


XDT>G 
RSX11M V4.2 BL38 


>TIM 12:00 15-JUN-85 
>SAV /WB 


RSX11M V4.2 BL38 128.K MAPPED 
>RED DR: =SY: 
>RED DR:=LB: 
>MOU DR:RSXM38 
>@DR: [1,2]STARTUP 


End of SYSGEN phase II at 15:19:32 on 12-JUN-85 


<EOF> 


End of SYSGEN phase I at 18:26:40 on 13-JUN-85 @ 
-~- Chaining to [200,200]SYSGEN2.CMD 


>s 
>SET /UIC=[200, 200] 


>; 


RSX-11M V4.2 BL38 System Generation PHASE II -- Version 2.11 


13-JUN-85 18:26:42 
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>; Big disk distribution kit SYSGEN version 2.10 for RSX-11M BL38 
>; Continuation from SYSGEN PHASE I done on 13-JUN-85 at 18:26:39 


>; SYSGEN assumes that the map disk is already mounted in SY0: with 
>; UFD [1,34]. 
> 
>i 
>INS SY: [1,54] TKB.TSK;1/TASK=...TKL 
v 
; Phase II input saved answers 
>; created on 12-JUN-85 at 15:15:05 
>; by SYSGEN version 2.11 
3; are from file DUO: [200,200]SYSSAVED.CMD;1 


; Phase II output saved answers created in file DUO: [200,200]SYSSAVED.CMD;2 © 
>: 

>ASN SY:=LB: 

>PIP /FR 


DUO: has 191173. blocks free, 46039. blocks used out of 237212. 
Largest contiguous space = 105488. blocks 
6873. file headers are free, 1226. headers used out of 8099. 


; Start of library build at 18:27:02 on 13-JUN-85 


>SET /UIC=[1,1] 

>PIP LB: ANSLIB.OLB/NV=LB:SYSLIB.OLB 
>LBR LB: ANSLIB/RP=SY0:FCSMTA 

Module “ANSPAD" replaced 


Module "ASSLUN" replaced 
Module "BIGBUF" replaced 
Module "CLOSE “ replaced 
Module "“CONTRL" replaced 
Module "CREATE" replaced 
Module "DIRECT" replaced 
Module “FCSTYP" replaced 
Module "GET " replaced 
Module "GETSQ " replaced 
Module "OPEN " replaced 
Module "OPENR " replaced 
Module "OPFID " replaced 
Module "OPFNB " replaced 
Module "PARSFN" replaced 
Module “POINT “ replaced 
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Module "PUT " replaced 
Module "PUTSQ " replaced 
Module "RDWAIT" replaced 
Module "RETADR" replaced 
Module "RSTFDB" replaced 
Module "RWBLK " replaced 
Module "“RWLONG" replaced 


Module "WATSET" replaced 
Module "WTWAIT" replaced 
Module "WTWATD" replaced 
>SET /UIC=[1,24] 

>LBR SY0:MCR/RP=SY0:MCR.OBJ 
Module "DV20V " replaced 
Module "SPSOV " replaced 
“Module "STSUB " replaced 
Module "SX10V " replaced 
Module "SX20V " replaced 
Module "SX30V " replaced 


Module "SX40V " replaced 


Module "ST50V " replaced 

; End of library build at 18:31:46 on 13-JUN-85 
>; Start of Executive task build at 18:31:47 on 13-JUN-85 
>PIP [1,34]*.*;*/DE/NM 

>TKL @LB:RSXBLD 

3; End of Executive task build at 18:36:51 on 13-JUN-85 
>PIP LP:=SY0: [1,34]RSX11M.MAP 


; Start of system image creation at 18:36:53 on 13-JUN-85 


>PIP RSX11M.SYS/CO/NV/BL: 498. =RSX11M.TSK 


’ 


7 End of system image creation at 18:36:58 on 13-JUN-85 


>; Start of full duplex terminal driver task build at 18:36:58 on 13-JUN-85 


v 
>SET /UIC=[1, 24] 
>TKL @LB:TTDRVBLD 
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>} 

>; End of full duplex terminal driver task build at 18:38:17 on 13-JUN-85 
>; 

>3 

>; Start of loadable driver task build at 18:38:17 on 13-JUN-85 

>; 

>TKL @SY0:DUDRVBLD 

>TKL @SYO0:MUDRVBLD 

>TKL @SY0:LPDRVBLD 


>; End of loadable driver task build at 18:40:03 on 13-JUN-85 


>; Start of common block task build at 18:40:03 on 13-JUN-85 


; Build the ANSLIB flavor of the FCS resident library common 


; Creating the task build .CMD and .ODL files in SY: [1,24] 
td 
>TKL @SY: [1,24]FCSRSIBLD.CMD 


>; End of common block task build at 18:42:11 on 13-JUN-85 
; Start of privileged task build at 18:42:11 on 13-JUN-85 


>; Note that the following tasks will be built for your system: 


>; BOO DMO FCPMDL ICP INI INS PMT 

>? MCR DCL MOU QMG QMGCLI QMGPRT LPP 
; FI11MSG MTAACP SAV TKTN UFD LOA UNL 
; PMD RMD SHF ACNT BYE HEL BRO 
; SHUTUP ACS ERRLOG ELI RCT 


; It is assumed that [1,1]FCSRES.STB is an ANSLIB version of the FCS 
; resident library 


; Creating the task build .CMD and .ODL files in SY: [1,24] 


’ 


>TKL @SY:[1,24]BOOBLD.CMD 
>TKL @SY: [1,24] DMOBLD.CMD 
>TKL @SY:[1,24]FCPMDLBLD.CMD 
>TKL @SY: [1,24] ICPBLD.CMD 
>TKL @SY: [1,24] INIBLD.CMD 
>TKL @SY: [1,24] INSBLD.CMD 
>TKL @SY: [1,24] PMTBLD.CMD 
>TKL @SY: [1,24]MCMBLD.CMD 
>TKL @SY:[1,24]DCLBLD.CMD 
>TKL @SY: [1,24]MOUBLD.CMD 
>TKL @SY: [1,24]QMGRESBLD.CMD 
>TKL @SY: [1,24] QCLRESBLD.CMD 
>TKL @SY:[1,24]QPRBLD.CMD 
>TKL @SY: [1,24] LPPRESBLD.CMD 
>TKL @SY:[1,24]F11MSGBLD.CMD 
>TKL @SY: [1,24]MTABLD.CMD 
>TKL @SY:[1,24]SAVBLD.CMD 
>TKL @SY: [1,24] TKNBLD.CMD 
>TKL @SY: [1,24]UFDBLD.CMD 
>TKL @SY: [1,24] LOABLD.CMD 
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>TKL 
>TKL 


@SY: [1,24] UNLRESBLD.CMD 
@SY: [1,24] PMDRESBLD.CMD 


>TKL 
>TKL 
>TKL 
>TKL 
>TKL 
>TKL 
>TKL 
>TKL 
>TKL 
>TKL 
>TKL 
>i 


; End of privileged task build at 


/UIc=[1,5 


SY: SBOO; - 
SY: SVMR;- 
SY:=LB: 

@sysvmr @ 


EXCOM1 


EXCOM2 
TT: 


SET /TOP=DRVPA 


Start of system VMR at. 20:31:12 


4] 


ab 
1 


*DIAG*-Partition reduced to 


*DIAG*-Partition reduced to 


R:-* 


@SY: [1,24] RMDBLD.CMD 
@SY: [1,24]SHFBLD.CMD 
@SY: {1,24 ]ACNRESBLD.CMD 
@SY: [1,24]BYEBLD.CMD 
@SY: [1,24] HELRESBLD.CMD 
@SY: [1,24]BROBLD.CMD 
@SY: [1,24] SHUBLD.CMD 
@SY: [1,24]ACSRESBLD.CMD 
@SY: [1,24] ERLBLD.CMD 
@SY: [1,24 ]ELIRESBLD.CMD 
@SY: [1,24]RCTBLD.CMD 


-- *DIAG*-Loadable driver larger 


-- *DIAG*-Installed tasks may no 


POOL=1200:8700.:08700. @ 


EXCOM1 117734 00120000 00014600 MAIN COM 
EXCOM2 117670 00134600 00010300 MAIN COM 
LDRPAR 117624 00145100 00002600 MAIN TASK 
TTPAR 117260 00147700 00040000 MAIN TASK 
DRVPAR 116734 00207700 00024600 MAIN SYS 
116470 00214400 00007400 SUB DRIVER - MU: 
116370 00224000 00010200 SUB DRIVER - DU: 
116254 00234200 00000300 SUB DRIVER - LP: 
SYSPAR 116210 00234500 00011700 MAIN TASK 
PUCOM 116144 00246400 00007500 MAIN COM 
FCSRES 116100 00256100 00040000 MAIN COM 
FCPPAR 116034 00316100 00024200 MAIN SYS 
GEN 115770 00342300 03435500 MAIN SYS 
LDR... 13.02 117510 LDRPAR 248. 00002600 LBO:-00124326 FIXED 
TKTN 05.00 111304 SYSPAR 248. 00011700 LBO0:-00130111 
«RMD 03.00 114630 GEN 225. 00027200 LBO:-00130711 
F1L1IMSG 13.00 113720 GEN 200. 00005700 LB0:-00125745 
MTAACP 15.00 113604 GEN 200. 00014700 LBO:-00130370 
--DMO 04.00 114264 GEN 160. 00014600 LBO:-00126070 
MCR... 05.00 112560 SYSPAR 160. 00011700 LBO:-00112376 
-.DCL 4.2 112444 GEN 160. 00051500 LB0:~-00127242 
«MOU 27.00 111764 GEN 160. 00037700 LBO:-00126676 
--MCR 03.00 111420 GEN 160. 00020000 LB0:-00127042 
FLIACP 05.00 115654 FCPPAR 149. 00024200 LBO:-00126171 
ERRLOG 2.00 114150 GEN 148. 00040000 LB0:-00125757 
PMT... 2.00 113124 GEN 148. 00006300 LB0O:-00126351 
PMD... 08.00 113010 GEN 140. 00016200 LBO0:-00130663 
SHF... 6.00 111534 SYSPAR 105. 00011700 LBO:-00130143 
--INS 9.00 113240 GEN 100. 00034600 LBO0:-00126637 
--SAV 05.00 111650 GEN 100. 00033200 LBO:-00130552 
--UFD 05.00 111170 GEN 100. 00005700 LBO:-00130121 


20:31:12 on 13-JUN-85 


on 13-JUN-85 


executive common size 


executive common size 


than 4K 


longer fit in partition 


\ 
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RCT... 05.00 110740 GEN 100. 00010700 LBO:-00131341 
QMG... 03.03 115424 GEN 75. 00031700 LBO:-00126754 
PRT... 2.0 115060 GEN 70. 00001100 LBO:-00127010 
LPO 04.01 114744 GEN 70. 00014500 LBO:-00130156 
«ACS 3.00 114514 GEN 70. 00005000 LBO:-00131310 
--AT. 8.0 113354 GEN 64. 00060000 LBO:-00126443 
«- QUE 05.00 115310 GEN 50. 00020100 LBO:-00127763 
«»PRI 05.00 115174 GEN 50. 00020100 LBO:-00127763 
--BOO 06.02 114400 GEN 50. 00021700 LBO0:-00126027 
«ELI 1.00 114034 GEN 50. 00017300 LBO:-00131317 
«-MAG 03.00 113470 GEN 50. 00031500 LBO:-00130043 
--LOA 04.02 112674 GEN 50. 00032600 LBO:-00130306 
«HEL 03.00 112330 GEN 50. 00024000 LBO:-00131211 
» BYE 06.00 112214 GEN 50. 00012500 LBO:-00131150 
-»BRO 06.00 112100 GEN 50. 00030400 LBO:-00131255 
«UNL 4.02 111054 GEN 50. 00024500 LBO:-00130634 
LPO: Loaded 

DLO: 

DUO: Loaded 

DUL: Loaded 

DU2: Loaded 

MUO: Loaded 

coo: tTTO: 

TTO: Loaded 

TT1l: Loaded 

TT2: Loaded 
—TT32 Loaded 

TT4: Loaded 

TTS: Loaded 

NLO: 

TIO: 

coo: tTTO0: 

CLO: tTTO: 

LBO: DBO: 

SY0O: DBO: 

>} 

>; End of system VMR at 20:41:17 on 13-JUN-85 
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>3 

>; An alternate version of SYSLIB.OLB, the system object library, was 


created to provide support for ANSI magtape/FCS big-buffering (which 
you selected in Phase I). You may want to rebuild DMP, FLX, PIP, and 
VFY in Phase III to use ANSLIB.OLB. Note, however, building tasks with 
ANSLIB.OLB causes an increase in the size of tasks as compared to the 
SYSLIB.OLB version of the tasks. 


A memory resident library of FCS routines (which you selected in Phase I) 
was built to help reduce task memory requirements. You may want to rebuild 
tasks in Phase III to link to the FCS resident library. 


; When SYSGEN finishes, boot in your target system, and save the system with a 


bootstrap. For example: 


>BOO 
XDT: 


{1,54]RSX11M 
38 


XDT>G 
RSX11M V4.2 BL38 


>TIM 12:00 15-JUN-85 
>SAV /WB 
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>; RSX11M V4.2 BL38 128.K MAPPED 


>; >RED DR: =SY: 
>; >RED DR:=LB: 
>; >MOU DR:RSXM38 
>; >@DR: ([1,2]STARTUP 
>; ‘ 
>3 e 
>; $ 
; 
>REM TKL 


>; 

>; End of SYSGEN phase II at 20:41:18 on 13-JUN-85 
>; 

>SET /UIC=[200, 200] 

>@ <EOF> 

> 

>3 

>} 

>BOO [1,54]RSX11M@ 

XDT: 38 


RSX11M v4.1 BL38 


, 
>TIM 20:42 13-JUN-85 
>TIM 
20:42:13 13-JUN-85 
>SAV /WB 


RSX-11M V4.2 BL38 128.K MAPPED 
>RED DU:=SY:. 
>RED DU:=LB: 
>MOU DU:RSXM38 
>DU: [1, 2] STARTUP 


>* PLEASE ENTER TIME AND DATE (HR:MN DD-MMM-YY) [S]: 20:43 13-JUN-85 
>TIM 
>TIM 20:43 13-JUN-85 
>* ENTER LINE WIDTH OF THIS TERMINAL [D D:132.]: 
>SET /BUF=TI:132 
>ACS SY:/BLKS=512 
, 
>; This system startup:command file (LB: [(1,2]STARTUP.CMD) contains a 
; template of commands to initialize the queue print spooler and 
>; queue LPO:, initialize the error logger, initialize the DCL CLI, 
>; and install the RMS Library and Utilities. As is, these commands 
; are written as comments and are not executed. To include these 
>; commands as part of the startup procedure, edit the file to remove 
3; the period and semicolon (.;) comment delimiter from the beginning 
; of each line. These commands may be useful for initializing the 
; various facilities for your installation or else they may provide 
>; a model with which to tailor initializaton commands for your 
>; particular installation. 


>@ <EOF> 
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Notes for the terminal output from SYSGEN Phase II (for a mapped 
target system) while running qn a baseline system. 


Chain to Phase II of SYSGEN, then continue answering 
questions. Note that this example shows a SYSGEN in which 
chaining from Phase I to Phase II was selected. If you are 
not chaining; you invoke Phase II by issuing the following 
command: 


>@SYSGEN2 


At this point, Phase II of PREPGEN ends, and Phase II of 
SYSGEN begins. 


The default name for the output saved answer file from Phase 
I is SYSSAVED.CMD. Press the RETURN key if you want to 
specify the same file name for the ouput saved answer file 
from Phase II. At the end of Phase II, if you select the 
default name of the output saved answer file, SYSGEN will 
have created a single saved answer file named SYSSAVED.CMD 
that contains the responses from Phase I and Phase MII 
questions. 


You may see some diagnostic (*DIAG*) messages in your 
terminal output during the System VMR Section of Phase II. 
They are no cause for concern; they simply supply diagnostic 
information about partition sizes. (See Chapter 10 of the 
RSX-11M/M-PLUS System Management Guide for explanations of 
the VMR messages.) 


During the System VMR Section, VMR displays information 
concerning pool, partitions, installed tasks, and devices as 
an indication of its successful completion. 


At the end of Phase II, you can optionally bootstrap your 
unsaved system and make it hardware-bootable. See Chapter 6 
for details. : 


NOTE 


If you are generating an unmapped target system, 
follow the instructions at the end of Phase II. Refer 
to Chapter 6 for suggestions on procedures to follow 
between Phase II and Phase III. 


CHAPTER 6 


POST-SYSTEM-GENERATION GUIDELINES 


After the completion of SYSGEN Phase II, several steps remain before 
your system generation is actually complete. These steps vary 
depending on whether you are generating a mapped or an unmapped system 
and whether you are running SYSGEN stand-alone or on line. This 
chapter describes some of those steps and provides some suggestions 
for maximizing utilization of your system resources. 


The information presented in this chapter is only a guideline. The 
steps presented occur in a sequence and, therefore, are not intended 
to be executed at random. You may, however, find that you can_ skip 
some of the steps because of the type of distribution kit you have, 
the type of system you have generated, and the level of backup 
security needed. 


6.1 DO YOU HAVE AN UNSAVED SYSTEM? 


At the end of Phase II--after SYSVMR.CMD has increased the system 
image file (RSX11M.SYS)--SYSGEN has produced a bootable RSX-11M system 
known as an unsaved system. Once you have bootstrapped and saved a 
system, that system is referred to as the saved target system. These 
are necessary distinctions within the context of this chapter. (See 
the definition of unsaved system and target system in Chapter 1.) You 
must have an unsaved system to begin performing the steps listed in 
this chapter. 


If you are generating your RSX-11M system from an on-line host, SYSGEN 
completes Phase II without invoking SYSVMR.CMD. If you have not 
already done so, make any necessary edits to SYSVMR.CMD and then 
invoke VMR as described at the end of Chapter 5. 


6.2 STEPS FOR MAPPED TARGET SYSTEMS 


If you have a mapped unsaved system, follow the procedure beginning at 
Section 6.2.1 after Phase II completes. 


If you have either a standard, unmapped unsaved system (where the base 
address of the GEN partition is the standard address of 40000) or a 
nonstandard, unmapped unsaved system (where the base address of the. 
GEN partition is at an address of other than 40000), start at Section 
6.3. 
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NOTE 


In the following procedure, assume that ddu: contains 
the unsaved system on the disk volume labeled RSXM38, 
and that RSXM38 contains a mapped 124K unsaved system 
in directory [1,54] and includes support for the 
Executive Debugging Tool (XDT). 


6.2.1 How to Bootstrap the Unsaved System 
Follow the steps listed to bootstrap and save the unsaved system. 


If the unsaved system includes support for the Executive Debugging 
Tool (XDT), the console terminal displays a prompt from XDT (XDT>) 


during the bootstrap procedure. To continue, enter a G from _ the 
console terminal. 


Note that, if you are generating your system from a stand-alone host 
system, you must install the version of BOO ($B00;1) built to run on 
the baseline system, not the most recent version of BOO (SBOO) built 
to run on the target system. Also note that bootstrapping the unsaved 
system from an on-line host system aborts the current running system 
and brings up the unsaved system. 


>INS SBOO;1 @ED (For a stand-alone host system) 
>INS SBOO (ED (For an on-line host system) 


>BOO ddu: [1,54]RSX11M.SYS 
XDT: 38-A 
XDT>G 


RSX11M V4.2 BL38 


>TIM 11:23 10-MAY-85 (ED (Set the time and date) 
>TIM (Enter the TIME command) 
11:24 10-MAY-85 

> 


The purpose of entering the TIME command after you set the time and 
date is to ensure that your new system performs some fundamental 
operations. The TIME command utilizes enough of the system resources 
to be a satisfactory test. 


Now you are ready to save your system and make the target system 
hardware-bootable. 


6.2.2 How to Make Your Target System Hardware-Bootable 


Follow the steps below to save your target system. You use the SAVE 
/WB command to make the target system disk hardware-bootable. See the 
SAVE command in the RSX-11M/M-PLUS MCR Operations Manual for details 
on what happens when you save the system. 


NOTE 


If you do not want to write the bootblock the first 
time you save the system, omit the /WB switch the 
first time through the procedure. When you are 
satisfied that the system works correctly after saving 
it, repeat. the following steps and include the /WB 
switch. 
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Once you have completed the following steps, your target system disk 
can be hardware bootstrapped to bring up your new RSX-11M system. 


>SAV /WB 
RSX11M V4.2 BL38 124.K MAPPED 


>RED ddu:=SyY: 
>RED ddu:=LB: 


>MOU ddu: RSXM38 @ED 


>@ddu: [1,2]STARTUP.CMD 
>* PLEASE ENTER TIME AND DATE (HR:MN DD-MMM-YY) [S]:11:30 1LO-MAY-—85 ED 


6.2.3 Invoke Phase III to Task Build BRU 


To execute some of the remaining steps in this chapter, you need to 
build the Backup and Restore Utility (BRU). The most efficient way to 
do this is to invoke Phase III of SYSGEN and task build BRU. Refer to 
Chapter 7 for details on Phase III. After you task build the utility, 
exit from Phase III, install BRU, and resume working at the next step. 


NOTE 


“You may want to back up the system disk at several 
intervals during the remaining steps to. protect 
yourself against any accident that might corrupt the 
contents of the system disk. Backing up the system 
disk is not critical at this point. However, after 
you task build BRU, you may back up your system disk 
whenever you like. (See Section 6.2.11.) 


6.2.4 How to Recover Space on the Target System Disk 


To make efficient use of the space available on your target system 
‘disk, you should delete unnecessary files from the disk. This is an 
optional step, particularly for users with larger distribution kits. 
However, RLOL/RLO2 users may find this step useful. 


NOTE 


Be sure that you have saved your system and made the 


target system disk hardware-bootable before proceeding 
with these steps. 


Follow the steps below for recovering space on the target system disk: 


1. Purge the system directory to eliminate baseline files that 
have been superseded by target system files: 


>SET /UIC=[1,54] 
>INS S$PIP 
>PIP ddu:*.*/PU 
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2. Delete the privileged baseline files that were not eliminated 
by the purge operation. Files to delete may include the 
baseline Autoconfigure task ACF.BSL, baseline drivers’ for 
devices not supported on your target system, and the baseline 
FCP FCPSML.TSK. 


‘ 


>SET /UIC=[1,54] 
>PIP ddu:ACF.BSL;1/DE,DPDRV.*;1,FCPSML.TSK;1 @ED 


3. Use BRU to back up the target system disk to another disk of 
the same type (this disk should be checked for bad blocks 
using the BAD utility before invoking BRU) or to a magnetic 
tape to provide the largest possible contiguous space. (If 
you are copying from disk to disk, this step recovers’ the 
noncontiguous space freed by the files that were deleted and 
purged.) For example, assume dduu: is a second disk drive: 


>INS SBRU 

>ACS ddu:/BLKS=0 
>DMO ddu:/DEV 
>BRU/INI/VER 
From: ddu: 

To: dduu: 


BRU > CiRLz) 


or if mtu: is a magnetic tape drive on a system with a 
single disk drive: 


>INS SBRU 

>LOA mtu: 

>ACS ddu:/BLKS=0 

>DMO ddu:/DEV 

>BRU/DENS : number /REW/VER 
From: ddu: 

To: mtu: 


BRU> 


If you used two disks for the BRU operation, remember that the newly 
copied disk should now be your new system disk. The disk that you 
used to make the new copy is now your backup copy. 


When you have copied the disk, bootstrap the new system disk (that is, 
the one you just compressed) and continue with the remaining steps. 


6.2.5 Building or Rebuilding RSX-11M Tasks 


Invoke -SYSGEN Phase III to build or rebuild nonprivileged, 
DIGITAL-supplied RSX-11M tasks. (See Chapter 7 for details on SYSGEN 
Phase III.) 


DMP, FLX, PIP, and VFY can use ANSI magnetic tape or big-buffering 
capabilities, provided that you generated ANSI magnetic tape or 
big-buffering support into your target system. If you want any of 
these tasks to have ANSI magnetic tape or big-buffering capabilities 
(and if your target system includes the necessary support), invoke 
Phase III to build these tasks to link to ANSLIB.OLB. 


A number of RSX-11M nonprivileged tasks can link to the FCS’ resident 
library (on mapped systems). If your system has support for the FCS. 
resident library and if you want specific tasks to link to that 
library, invoke Phase III to build those tasks. Chapter 7 includes a 
list of tasks that can be linked to FCSRES. 
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If you are using the RLO1/RLO2 distribution kit, the following tasks 
are not in the baseline system: 


BAD CDA CMP CRF DMP DSC EDT 
FMT FTB IOX PAT RPT VEY ZAP 


If you want to include any of these tasks in your target system, 
invoke Phase III to build them. (BRU is available only on mapped 
systems. EDT is available only on mapped systems with the full-duplex 
terminal driver.) 


6.2.6 How to Transfer the Target System to a Different Type of Disk 


This is an optional step intended for those users who need to transfer 
the unsaved target system to a different type of disk. If this is not 
a concern for you, skip this section and go to the next one. 


If you intend to transfer your unsaved target system to a different 
type of disk, the system data base must adequately reflect the 
characteristics of the new target system disk. To do this, you must 
invoke VMR and re-create the system image using the new target system 
disk's characteristics. The reason for this is that the physical disk 
locations of the installed tasks on the new disk are different from 
those stored in the system image file, which still has the disk 
locations of the installed tasks for the old target disk. For 
example, if you copied your unsaved target system from an RKO7 to an 
RMO5, and if you were able to software bootstrap the RMO5 disk, your 
System will not be able to find any of the installed tasks because the 
tasks are probably stored in different disk locations than the system 
expects. If you do not change the system image file, your system will 
be unpredictable at best. 


NOTE 


Your response to the SYSGEN question regarding the 
unit supported by the device controller must have been 
the exact device to which you intend to transfer your 
target system. For example, if you selected RK06/RK07 
support, your response to the SYSGEN question 
regarding the unit supported by the DM controller must 
match exactly the device that you want to be hardware- 
bootable. : 


If you did not specify the correct device during SYSGEN, either 
explicity or by selecting the default response, you must perform 
another SYSGEN and supply the correct reponse in the Peripheral 
Options Section. 


Once you have ensured that the necessary device controller support is 
included in your system, use the following procedure to transfer your 
target system to the new target system disk: 


1. Use the BAD utility to check for bad blocks on the disk to 
which you intend to transfer the target system. Then, 
initialize the disk with the MCR INI command. (See the 
RSX-1L1IM/M-PLUS Utilities Manual for information on the BAD 
utility. The RSX-11M/M-PLUS MCR Operations Manual contains 
information on the MCR INI command.) 
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2. Software mount the disk to which you intend to transfer the 


target system (assume that dduu: contains the disk to which 
you are copying the target system): 


>MOU dduu:RSXM38 


3. Copy the system directories to the new target system aa wie 


(>) PIP dduu: [*,*] /NV/UF/FO=ddu: [1,1]*.*,[1,2]*.*,[1,54]*.* GED 
(>) PIP dduu: [*,*]/NV/UF/FO=ddu: [1,3]*.*,[1,4]*.*,[1,6]*.*,[1,7]*.* RED 


4. Reassign the logical devices SY: and LB: to the new target 
system disk: 


>ASN dduu:=SyY: 
>ASN dduu: =LB: 


5. Re-create the system image on the new target system disk: 


>SET /UIC=[1,54] 
>PIP RSX11M.SYS/NV/CO/BL: <n>=RSX11M.TSK 


where <n> = (size of memory * 4) + 2 


The memory size is the response given during SYSGEN_ to 
Question 3 in the Target Configuration Section. 


6. Install VMR and invoke SYSVMR.CMD: 


>INS dduu: SVMR 
>VMR @SYSVMR 


To avoid any incompatibility problems, the version of VMR 


that you are using must originate from your target system 
disk. . 


7. After VMR has updated the system image file and produced an 
unsaved system, software bootstrap the unsaved system and 
then use the MCR SAVE command to make the disk 
hardware-bootable. (Refer to Sections 6.2.1 and 6.2.2 for 
those procedures.) 


6.2.7 Rebuilding User-Written Tasks 


If you have a mapped system with FCS resident library (FCSRES) support 
or ANSI support and you want your user-written tasks to use these 
resources, rebuild those tasks to include the desired support. 


See the RSX-11M/M-PLUS and Micro/RSX Task Builder Manual for details 


on specifying ANSLIB.OLB with the /DL switch as the default library 
and for details on using the LIBR or RESLIB options to link to FCSRES. 


Remember to rebuild your privileged user-written tasks to link to’ the 
target Executive. 


6.2.8 Help Files 


Each distribution kit includes the file HELP.ULB, which consists of 
the various help files for the MCR, DCL, and utility commands. In 
addition, there are introductory files included in HELP. ULB that are 
referred to in the Introduction to RSX-11M. 
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You can find HELP.ULB in directory [1,2] on all distribution kits. 


However, 


the volume on which the help files reside differs for each 


type of kit. The following lists the various distribution kits and 
the various locations for HELP.ULB: 


Distribution Kit Volume 
Big-disk RS XM38 
RKO6/RK07 CLISRC 
RLO1/02 HLPDCL 


Follow these steps to get HELP support: 
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Establish [1,2] as the default directory for the terminal: 
>SET /UIC=[1,2] 


Copy HELP.ULB to the LB: device (skip this step if you are 
using a big-disk distribution kit): 


>PIP LB:/NV=ddu :HELP.ULB 


If you have an RLO1/RLO2 magnetic tape distribution kit and 
you did not copy over your help files earlier, you must 
invoke and run BRU to copy the files from tape to disk. To 
do this, mount the distribution tape onto a magnetic tape 
drive (if the distribution tape is 800 bpi, mount the second 
tape volume) and issue the following command lines to BRU: 


>BRU 
BRU>/NOI/BAC:HLPDCL/DENS : number /REW/VER 
From: MM: [1,2]HELP.ULB 

To: LB: 


NOTE 


RLO1/RLO2 users may not have sufficient space 
on the target system disk for all of the help 
files. In such cases, your LB: device 
should point to another type of disk or you 
should print the help files as a listing 
using the LBR utility to extract the files. 
(See the RSX-11M/M-PLUS Utilities Manual for 
details on using LBR.) 


Extract the build module from HELP.ULB, then name this module 
HELPBUILD.CMD: 

>LBR HELPBUILD.CMD=HELP. ULB/EX: BUILD 
Invoke the HELPBUILD command file: 

4 

>@HELPBULLD (ED) 
HELPBUILD.CMD asks a series of questions that allow you _ to 
build either FULL or BRIEF HELP support for MCR and DCL 
commands and the RSX-11M utilities. ~In addition, 


HELPBUILD.CMD allows you to select the introductory files 
used with the Introduction to RSX-11M. 
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5. When you finish extracting the desired modules from HELP.ULB, 
delete the files HELPBUILD.CMD and HELP.ULB from LB:. 


>PIP HELPBUILD.CMD;*,HELP.ULB;*/DE (ED) 


See the HELPBUILD.CMD file for more information. 


6.2.8.1 Files for the Introduction to RSX-11M - HELP.ULB includes 
introductory files that are referred to in the warm-up session in the 
Introduction to RSX-11M. You can use these files in two ways, 
depending on the number of new users that will be using your system. 


1. You can put the files in [200,1] and create an account with 
the name USER and the UIC [200,1]. New users can then log in 


to the USER account when they are doing the warm-up session 
in the Introduction to RSX-11M. 


2. You can put separate copies of the files in each new user's 
account, then instruct each user to delete the introductory 
files when he or she has completed the warm-up session. 


To put the introductory files into account [200,11], or to copy’ the 
files into a new user's account, perform the following procedure: 


1. Extract the introductory files from [1,2]HELP.ULB (using the 
instructions provided in this section). 


2. Set your UIC (using the SET /UIC=[g,m] command) to [200,11], 
or to the new user's account, depending on where you want to 
copy the files. 


3. Copy the files INTRO.ULB and INTROFIL.CMD from directory 


[1,2] to the UIC that you set in Step 2. The copy command 
is: 


>PIP /NV=[1,2]INTRO.ULB, INTROFIL.CMD ED 


4. Use the following command to execute INTROFIL.CMD to extract 
the introductory files from INTRO.ULB: 


>@INTROFIL 


6.2.9 Multiuser System Setup 


If you have a multiuser system, you should run the Account File 
Maintenance Program (ACNT) to create an account file and user 
accounts. If you have a previously created account file, copy the 
account file to the new system disk. For details on ACNT, see the 
RSX-11M/M-PLUS System Management Guide. 


You should also use an editor to create the file LOGIN.TXT in 
directory [1,2] on your LB: device to provide installation news and 
notices to system users. For details on LOGIN.TXT, see the MCR 
HEL/LOG command in the RSX-11M/M-PLUS MCR Operations Manual. 


You can tailor [1,2]STARTUP.CMD to your particular installation's 
needs. Following are some of the functions that you may want 
STARTUP.CMD to perform: 


e Set the speed and type of terminals. (See the RSX-11M/M-PLUS 
MCR Operations Manual for details on the MCR SET command.) 
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e Install resident libraries (RMS-11l on mapped systems only; see 
Section 6.2.12), utilities, and user’ tasks. (See the 


RSX-11M/M-PLUS MCR Operations Manual for details on the MCR 
TALL command.) 


e Initialize the Queue Manager and Print Spooler (on mapped 
systems only) if the system includes Queue Manager support. 
(See the RSX-11M/M-PLUS Batch and Queue Operations Manual for 
details on the Queue Manager.) The STARTUP.CMD file contains 
commands in commented form that provide a template for 
initializing the Queue Manager. 


e Initialize DCL (on mapped systems only) if the system includes 


support for DCL. (See the RSX-11M Command Language Manual for 
details on DCL.) The STARTUP.CMD file contains commands’ in 
commented form that provide a template for initializing DCL. 


e Initialize the Error Logger if the system includes support for 
error logging. (See the RSX-11M/M-PLUS Error Logging Manual 
for details.) The STARTUP.CMD file contains commands’ in 
commented form that provide a template for initializing the 
Error Logger. 


6.2.10 Establishing System Features with VMR 


If terminal speeds and types and partitions are stable and certain 
tasks are used frequently, you may want to establish these features in 
your system using VMR commands rather than having [1,2]STARTUP.CMD do 
it at bootstrap time. This decreases the amount of time required for 
the system to be ready for use after it has been bootstrapped. (See 
the RSX-11M/M-PLUS System Management Guide for details on VMR.) 


6.2.11 How to Create a Backup Copy of the Target System Disk 


Now that you have saved your target system, you should create a backup 
copy to protect yourself against any accident that might corrupt the 
contents of the disk. First, check the blank disk for bad blocks 
using the BAD utility. Then, using BRU, copy the target system disk 
either to another disk of the same type or to magnetic tape. For 
example, assume dduu: is a second disk drive: 


>BRU/INI/VER (ED) 
From: ddu: 
To: dduu: 
BRU> 


or mtu: is a magnetic tape drive: 


>BRU/DENS :number/REW/VER 
From: ddu: 
To: mtu: 


BRU> Gaz 


6.2.12 Installing RMS-11 V2.0 


On most mapped RSX-11M systems, all RMS-11 files are automatically on 
your system after SYSGEN. 
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However, for systems that were generated using either the RKO6 or’ the 
RLOL/RLO2 distribution kits, the RMS-11 files must be copied to the 
new system disk after SYSGEN. If your system was not generated using 
one of these kits, skip this section and continue with Section 
6.2.12.2. 


6.2.12.1 RKO6 and RLO1/RLO2 Procedures - To copy RMS-11 files to your 
new system disk, you must execute the command procedure 
[1,2]RMSINSTAL.CMD. Before you invoke this command file, you must 
task build BRU (see Section 6.2.3). After SYSGEN Phase III builds the 
BRU task, you should log into a privileged account and invoke 
RMSINSTAL.CMD using the following command line: 


>@[1,2]RMSINSTAL @ED 


This command procedure prompts you for information and executes’ the 
copy operation in the following manner: 


1. RMSINSTAL asks you if want all the RMS-11 files on your 
system. 


If you answer No to this question, all the RMS-11 files will 
be transferred except the .MAP files and the demonstration 
programs. . 


2. RMSINSTAL asks you to enter the name of the target disk that 
is to contain the RMS-11 files. 


This disk should be write-enabled. 


3. RMSINSTAL deletes all copies or previous versions of the 
RMS-1l1 files on the target disk that the procedure will be 
copying to that disk. This step allows you to restart 
RMSINSTAL if errors occur the first time it is invoked. 


4. RMSINSTAL displays the free space on the target disk and asks 
you if the target disk contains enough free space to copy the 
RMS-1l files. © 


5. RMSINSTAL displays a small table that assigns a number to 
each type of kit (RLO1/RLO2 disk, RLO1/RLO2 magnetic tape, 
RKO6 disk, RKO6 magnetic tape). 


Then RMSINSTAL asks you to enter the number that corresponds 
to your type of distribution kit. : 


6. If your distribution kit is on magnetic tape, RMSINSTAL asks 
you for the density (either 800 bpi or 1600 bpi). 


7.  RMSINSTAL asks you to physically mount the appropriate 


distribution disk or tape and then prompts you for the device 
name. 


8. RMSINSTAL generates the appropriate BRU commands that copy 
RMS-11 files from the distribution kit to the target disk. 
NOTE 
On the RKO6 disk and magnetic tape 


distribution kits, BRU may be run twice by 
RMSINSTAL. 
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When the BRU commands have been executed, the procedure 


displays the amount of remaining free space on the target 
disk. 


The RMS-1l file copy operation is now complete. For more information 
on RMS-11, see the RSX-1LIM/RSX-11S Release Notes. 


6.2.12.2 Startup Command Procedures - If all the RMS-1ll files have 
been transferred to your system, the next step is to install the 
resident library (or libraries) and the RMS-11 utilities during system 
startup. 


To do this, you should edit LB: {1,2]STARTUP.CMD. The commands’ to 
install the resident libraries and RMS-11 utilities already exist, 
except that the command lines have been commented out by the _ period 
and semicolon (.;) that begin each command line. Delete the period 
and semicolon that proceed each command line you want startup to 
execute. For those command lines that you do not want to be executed, 
leave the line as it is. 


Unless you have already done so with VMR (see Section 5.6.2), you must 
allocate a partition for each resident library you use by issuing MCR 
SET commands. Note that you must replace the word "base" with the 
octal address of the base of the partition. 


You can include MCR SET commands in your startup command file or you 
can permanently include the RMSRES and DAPRES partitions in your 
system by performing the following steps: 


1. Use MCR SET commands to include the necessary partions. 


2. Use MCR INSTALL commands to install the tasks in the running 
system. ~ 


3. Use the MCR SAVE command to save RMSRES and DAPRES into’ the 
system image. 


For information on the MCR SET, INSTALL, and SAVE commands, please see 
the RSX-11M/M-PLUS MCR Operations Manual. For more information on 
RMS-11, see the RMS-11 documentation and the RSX-11M/RSX-11S Release 
Notes. 


6.2.13 Error Logging Support 


If you want error logging support and you have already created your 
system from either an RKO6/RKO7 or an RLO1/RLO2 distribution kit, you 
must copy the following error logging files from either the CLISRC 
(RKO6), HLPDCL (RLO1l), or MCRSRC (RLO2) distribution disk or backup 
set to your default library disk (LB: [1,6]): 


[1,6] ERRLOG. ULB 
[1,6] ERRLOGETC. ULB 


The Report Generator (RPT) needs ERRLOG.ULB in order for it to work. 
ERRLOGETC.ULB contains a module named TUNE that fine tunes ERRLOB.ULB 
to your particular system by removing unneccessary modules in the 
universal library. For more information on RPT and ERRLOG.ULB, see 
the RSX-11M/M-PLUS Error Logging Manual. 
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6.2.14 Installing Layered Products in the Target System 


If you intend to include any layered products in your target system, 
you can do it now. Refer to the appropriate layered product 
documentation for specific instructions. 


6.3 STEPS FOR UNMAPPED SYSTEMS 


If you have an unmapped unsaved system, follow the procedure beginning 
at Section 6.3.1 after Phase II completes. 


NOTE 


In the following procedure, assume that ddu: contains 
the unsaved system on disk RSXM38 and that RSXM38 
contains an unmapped 28K unsaved system in directory 
[1,50]. 


6.3.1 Building or Rebuilding RSX-11M Tasks 


Invoke SYSGEN Phase III to build or rebuild nonprivileged, 
DIGITAL-supplied RSX-11M tasks that you want to start at the 
nonstandard (for nonstandard unmapped systems) or the standard (for 


standard unmapped systems) base address of the GEN partition in your 
target system. 


NOTE 


In order for your system to work correctly after you 
save the target system, be sure to build TKB, PIP, and 
EDI before you bootstrap the target system. (See 
Chapter 7 for details on SYSGEN Phase III.) 


6.3.2 How to Bootstrap the Unsaved System 
Follow the steps listed to bootstrap and save the unsaved system. 


Note that if you are generating your system from a_ stand-alone host, 
you must install the version of BOO ($BO00;1) built to run on the 
baseline system, not the most recent version of BOO ($BO0O) built to 
run on the target system. Also note that bootstrapping the unsaved 


system from an on-line host system aborts the current running system 
and brings up the unsaved system. 


>INS SBOO;1 ED (For a stand-alone host system) 
>INS SBOO ED (For an on-line host system) 


>BOO ddu: [1,50]RSX11M.SYS 


RSX11M V4.2 BL38 


>TIM 11:23 1O-MAY-85 ED) (Set the time and date) 
>TIM@ED (Enter the TIME command) 
11:24 10-MAY-85 

> ‘s 
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The purpose of entering the TIME command after you set the time and 
date is to ensure that your new system performs some fundamental 
operations. The TIME command utilizes enough of the system resources 
to be a satisfactory test. 


Now you are ready to save your system and write the hardware bootblock 
on the target system disk. 


6.3.3 How to Make Your Target System Hardware-Bootable 


Follow the steps below to save your target system. You use the SAVE 
/WB command to make the target system disk hardware-bootable. (See 
the SAVE command in the RSX-11M/M-PLUS MCR Operations Manual _ for 
details on what happens when you save the system.) 


NOTE 
If you do not want to write the bootblock the first 
time you save the system, omit the /WB switch the 
first time through the procedure. When you are 
satisfied that the system works correctly after saving 


it, repeat the following steps and include the /WB 
switch. 


Once you have completed the following steps, your target system disk 
can be hardware bootstrapped to bring up your new RSX-11M system: 


>SAV /WB 


RSX11M V4.2 BL38 28.K UNMAPPED 


>RED ddu:=SyY: 
>RED ddu:=LB: 


>MOU ddu:RSXM38 


>@ddu: [1,2] STARTUP.CMD 


>* PLEASE. ENTER TIME AND DATE (HR:MN DD-MMM-YY) [S]:11:25 10-MAY-85 ET 


6.3.4 Invoke Phase III to Task Build DSC 


To execute some of the remaining steps in this chapter, you need _ the 
Disk Save and Compress utility (DSC). The most efficient way to do 
this is to invoke Phase III of SYSGEN and task build DSC. Refer to 
Chapter 7 for details on Phase III. After you task build DSC, exit 
from Phase III, install DSC, and resume working at the next step. 
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NOTE 


You may want to back up the system disk at several 

intervals during the remaining steps to protect 

yourself against any accident that might corrupt’ the 

contents of the system disk. This is not critical. 

However, after you task build DSC, you may back up. 
your system disk whenever you like. (See Section 

6.3.9.2.) . 


6.3.5 How to Recover Space on the Target System Disk 


To make efficient use of the space available on your target system 
disk, you should delete unnecessary files from the disk. This is an 


optional step, particularly for users with larger distribution kits. 
However, RLO1/RLO2 users may find this step useful. 


NOTE 


Be sure that you have saved your system and made it 
hardware-bootable before proceeding with these steps. 


Follow these steps for recovering space on the target system disk: 


1. If you are using the big-disk distribution kit, delete the 
unused baseline system as follows: 


>SET /UIC=[1,54] 
>INS SPIP QED 
>PIP ddu:*.*;*/DE Re) 


2. Purge the system directory to eliminate files that have been 
superseded by target system files: 


>SET /UIC=[1,50] G&D 
>PIP ddu:*.*/PU GED 


3. Use DSC to copy the target system disk to another disk of the 
same type or to a magnetic tape to provide the largest 
possible contiguous’ space. (This step recovers the 
noncontiguous space freed by the files that were deleted and 
purged.) For example, assume dduu: is a second disk drive: 


>INS SDSC ED 

>ACS ddu:/BLKS=0 RED 
>DMO ddu:/DEV GED 

>DSC dduu:/VE=ddu : RED 


or if mtu: is a magnetic tape drive on a system with a 
single disk drive: 


>INS SDSC (ED 

>LOA mtu: 

>ACS ddu:/BLKS=0 @ED 

>DMO ddu:/DEV QED 

>DSC mtu: /VE=ddu : RED (disk to tape) 
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If you used two disks for the DSC operation, remember that the newly 
copied disk should now be your new system disk. The disk that you 
used to make the new copy is now your backup copy. 


When you have copied the disk, bootstrap the new system disk (that is, 
the one you just copied) and continue with the remaining steps. 


6.3.6 How to Transfer the Target System to a Different Type of Disk 


This is an optional step intended for those users who need to transfer 
the unsaved target system to a different type of disk. If this is not 
a concern for you, skip this section and go to the next one. 


If you intend to transfer your unsaved target system to a different 
type of disk, the system data base must adequately reflect the 
characteristics of the new target system disk. To do this, you must 
invoke VMR and re-create the system image using the new target system 
disk's characteristics. The reason for this is that the physical disk 
locations of the installed tasks on the new disk are different from 
those stored in the system image file, which still has the disk 
locations of the installed tasks for the old target disk. For 
example, if you copied your unsaved target system from an RKO7 to an 
RMO5, and if you were able to bootstrap the RM0O5 disk, your system 

will not be able to find any of the installed tasks because the tasks 
are probably stored in different disk locations than what the system 
expects. If you do not change the system image file, your system will 
be unpredictable at best. 


NOTE 


Your response to the SYSGEN question regarding the 
unit supported by the device controller must have been 
the exact device to which you intend to transfer your 
target system. For example, if you selected RK06/RK07 
support, your response to the SYSGEN question 
regarding the unit supported by the DM controller must 
match exactly the device that you want to be hardware- 
bootable. 


If you did not specify the correct device during SYSGEN, either 
explicity or by selecting the default response, you must perform 
another SYSGEN and supply the correct reponse in the Peripheral 
Options Section. 


Once you have ensured that the necessary device controller support is 


included in your system, use the following procedure to transfer your 
target system to the new target system disk: 


1. Use the BAD utility to check for bad blocks on the disk to 
which you intend to transfer the target system. Then, 
initialize the disk with the MCR INI command. (See the 
RSX-1LIM/M-PLUS Utilities Manual for information on the BAD 
utility. The RSX-11M/M-PLUS MCR Operations Manual contains 
information on the MCR INI command.) 


2. Software mount the disk to which you intend to transfer the 


target system (assume that dduu: contains the disk to which 
you are copying the target system): 


>MOU dduu:RSXM38 
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3. Copy the system directories to the new target system disk: 


>PIP dduu: [*,*] /NV/UF/FO=ddu: [1,1]*.*,[{1,2]*.*,[1,50]*.* GD 
>PIP dduu: [*,*] /NV/UF/FO=ddu: [1,3]*.*,[1,4]*.*,{1,6]*.*,(1,7]*.*@D | 


4. Reassign the logical devices SY: and LB: to the new target 
system disk: 


>ASN dduu:=SY: 
>ASN dduu: =LB: 


5. Re-create the system image on the new target system disk: 


>SET /UIC=[1,50] 
>PIP RSX11M.SYS/NV/CO/BL: <n>=RSX11M.TSK ED 


where <n> = (size of memory * 4) + 2 


The memory size is the response given during SYSGEN_ to 
Question 3 in the Target Configuration Section. 


6. Install VMR and invoke SYSVMR.CMD: 


>INS dduu: SVMR 
>VMR @SYSVMR @ED 


To avoid any incompatibility problems, the version of VMR 
that you are using must originate from the target system 
disk. 


7. After VMR has updated the system image file and produced an 
unsaved system, software bootstrap the unsaved system, and 
then use the MCR SAVE command to make the disk 
hardware-bootable. (Refer to Sections 6.3.2 and 6.3.3 for 
those procedures.) 


6.3.7 Rebuilding User-Written Tasks 


If your system includes ANSLIB.OLB (that is, if you selected ANSI 
magnetic tape support or big-buffering) and you want your user-written 
tasks to link to it, rebuild those tasks to include the necessary 
Support. 


See the RSX-11M/M-PLUS and Micro/RSX Task Builder Manual for details 


em 


on specifying ANSLIB.OLB as the default library using the /DL switch. 


Remember to rebuild your privileged user-written tasks to link to the 
target Executive. 


6.3.8 Help Files 


Each distribution kit includes the file HELP.ULB, which consists of 
the various help files for the MCR, DCL, and utility commands. In 
addition, there are introductory files included in HELP.ULB that are 
referred to in the Introduction to RSX-11M. 
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You can find HELP.ULB in directory [1,2] on all distribution kits. 
However, the volume on which the help files reside differs for each 
type of kit. The following lists the various distribution kits and 
the various locations for HELP.ULB: 


Distribution Kit Volume 
Big-disk RS XM38 
RK06/RK07 CLISRC 
RLO1/RLO2 HLPDCL 


Follow these steps to get HELP support: 
1. Establish [1,2] as the default directory for the terminal: 


>SET /UIC=[1,2] 


N 
e 


Copy HELP.ULB to the LB: device (skip this step if you are 
using a big-disk distribution kit): 


>PIP LB:/NV=ddu:HELP. ULB 


NOTE 


RLO1/RLO2 users may not have sufficient space 
on the target system disk for all of the help 
files. In such cases, your LB: device 
should point to a different type of disk or 
you should print the help files as a_ listing 
using the LBR utility to extract them. (See 
the RSX-11M/M-PLUS Utilities Manual for 
details on using LBR.) 


3. Extract the build module from HELP.ULB, then name this module 
HELPBUILD.CMD: 
>LBR HELPBUILD.CMD=HELP.ULB/EX: BUILD 
4, Invoke the HELPBUILD command file: 
> @HELPBUILD 
HELPBUILD.CMD asks a series of questions that allow you _ to 
build either FULL or BRIEF HELP support for MCR and DCL 
commands and the RSX-11M utilities. In addition, 
HELPBUILD.CMD allows you to select the introductory files 
used with the Introduction to RSX-11M. 
5. When you finish extracting the desired modules from HELP.ULB, 
delete the files HELPBUILD.CMD and HELP.ULB from LB:. 
CAUTION 


If you are using a big-disk distribution kit, 
do not delete HELP.ULB. It is your only 
copy. 


>PIP HELPBUILD.CMD;*,HELP.ULB;*/DE 


See the HELPBUILD.CMD file for more information. 


6-17 
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6.3.8.1 Files for the Introduction to RSX-l11M - HELP.ULB includes 
introductory files that are referred to in the warm-up session in the 
Introduction to RSX-11M. You can use these files in two ways, 
depending on the number of new users that will be using your system. 


1. You can put the files in [200,1] and create an account with 
the name USER and the UIC [200,1]. New users can then log in 
to the USER account when they are doing the warm-up session 
in the Introduction to RSX-11M. 


2. You can put separate copies of the files in each new user's 
account, then instruct each user to delete the introductory 
files when he or she has completed the warm-up session. 


To put the introductory files into account [200,1], or to copy the 
files into a new user's account, peform the following procedure: 


1. Extract the introductory files from [1,2]HELP.ULB (using the 
instructions provided in this section). 


2. Set your UIC (using the SET /UIC=[g,m] command) to [200,1], 
or to the new user's account, depending on where you want to 
copy the files. 


3. Copy the files INTRO.ULB and INTROFIL.CMD from directory 


[1,2] to the UIC that you set in Step 2. The copy command 
is: 


>PIP /NV=[1,2]INTRO.ULB, INTROFIL.CMD 


4. Use the following command to execute INTROFIL.CMD to extract 
the introductory files from INTRO.ULB: 


> @INTROFIL (ED) 


6.3.9 Multiuser System Setup 


If you have a multiuser system, you should run the Account File 
Maintenance Program (ACNT) to create an account file and user 
accounts. If you ‘have a previously created account file, copy the 
account file to the new system disk. For details on ACNT, see the 
RSX-11M/M-PLUS System Management Guide. 


You should also use an editor to create the file LOGIN.TXT in 
directory [1,2] on your LB: device to provide installation news and 
notices to system users. For details on LOGIN.TXT, see the MCR 
HEL/LOG command in the RSX-11M/M-PLUS MCR Operations Manual. 


You can tailor [1,2]STARTUP.CMD to your particular installation's 
needs. Following are some of the functions that you may want 
STARTUP.CMD to perform: 


@e Set the speed and type of terminals. (See the RSX-11M/M-PLUS 
MCR Operations Manual for details on the MCR SET command.) 


e Install resident libraries, utilities, and user tasks. (See 


the RSX-11M/M-PLUS MCR Operations Manual for details on the 
MCR INSTALL command.) 


e Initialize the Error Logger if the system includes support for 
error logging. (See the RSX-11M/M-PLUS Error Logging Manual 
for details.) The STARTUP.CMD file contains commands’ in 
commented form that provide a template for initializing the 
Error Logger. 
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6.3.9.1 Establishing System Features with VMR - If terminal speeds 
and types and partitions are stable and certain tasks are used 
frequently, you may want to establish these features in your system 
using VMR commands rather than having [1,2]STARTUP.CMD do it at 
bootstrap time. This decreases the amount of time required for the 
system to be ready for use after it has been bootstrapped. (See the 
RSX-11M/M-PLUS System Management Guide for details on VMR.) 


6.3.9.2 How to Create a Backup Copy of the Target System Disk - Now 
that you have set your target system, you should create a backup copy 
to protect yourself against any accident that might corrupt the 
contents of the target system disk. Using DSC, copy the target system 
disk RSXM38 either to another disk of the same type or to magnetic 
tape. For example, assume dduu: is a second disk drive: 


>DSC dduu:/VE=ddu: 
or mtu: is a magnetic tape drive: 


>DSC mtu:/VE=ddu: 


6.3.9.3 Installing Layered Products in the Target System - If you 
intend to include any layered products in your target system, you can 
do it now. Refer to the appropriate layered product documentation for 
specific instructions. 


CHAPTER 7 


DETAILS OF SYSGEN PHASE III 


Phase III is the last of the three interactive system generation 
procedures. This is the general task-building phase of SYSGEN. 
During Phase III, you can task build, or rebuild, any privileged or 
nonprivileged RSX-11M task. Figure 7-1 shows the logical flow of 
SYSGEN Phase III. You may find Phase III useful for rebuilding 
RSX-11M tasks that you have patched. You can also use Phase III to 
build RSX-11M tasks that are not available on the baseline system. 
Example 7-1 is an annotated terminal output from SYSGEN Phase III. 


INPUT ACTION OUTCOME 


EXPLICIT RESPONSES TASK-BUILD SPECIFIC 
PRIVILEGED AND TASK IMAGES 


TASK OBJECT FILES UNPRIVILEGED TASKS 


ZK-324-81 


Figure 7-1 Logical Flow of SYSGEN Phase III 


The indirect command file that controls Phase III execution is 
SYSGEN3.CMD. , 


If your target system is unmapped (regardless whether it is a standard 
or a nonstandard unmapped system), you have to build a few RSX-11M 
-nonprivileged tasks (PIP, TKB, and EDI) before you can use your new 
system. Also, if you specified during the Privileged Task-Build 
Section of Phase II that the base address for the GEN partition is 
something other than the default base address of 40000, you can easily 
build RSX-11M tasks with the desired GEN partition base address during 
Phase III. 


The distribution kits do not contain tasks linked to a resident FCS 
library (FCSRES). However, if your target system includes FCSRES, you 
can build nonprivileged tasks in Phase III to access FCSRES. 


The following is a list of some of the tasks that you can link to 
FCSRES: 


ACN CoT EDT HEL MAC PRT STK 
ACS CRF ELI TOX PAT QMGCLI TKB 
CDA DMP FLX LBR PIP QMG VEY 
CMP EDI FTB LPP PMD SLP ZAP 


DETAILS OF SYSGEN PHASE III 


If you selected ANSI magnetic tape support or support for big 
buffering during Phase I and if you want the DMP, FLX, PIP, or VFY 
utilities to use this support, you must build those tasks during Phase 
III. 


The task-build .CMD and .ODL files for RSX-11M tasks are not available 
on the distribution kit. Prior to task building a task, SYSGEN3 
dynamically creates the .CMD and .ODL files. 


Phase III consists of a single section of questions. 


7.1 PREPARING FOR PHASE III 


Before beginning Phase III of SYSGEN, be sure you have done the 
following: 


l. If you generated your system from an on-line Version 4.2 host 
system, set your directory to be [200,200], assign the 
logical device SY: to your baseline disk, and invoke 
SYSGEN3.CMD as follows: 


>SET /UIC=[200, 200] 

>ASN ddu:=SY: Qe?) - (where ddu: is your baseline disk) 
>MOU ddu: RSXM38 QED 

>@SYSGEN3 @& 


2. If you generated your system from a stand-alone Version 4.2 
host system, bootstrap the target disk (see Appendix B), then 
invoke SYSGEN3.CMD as follows: 


>SET /UIC=[200, 200] Ge 
> @SYSGEN3 @ED 


7.2 PHASE III QUESTIONS 
* 1. In what UIC is SGNPARM.CMD if not <uic> ? [S]: 


Enter the directory containing the file SGNPARM.CMD. SGNPARM.CMD 
_ supplies Indirect symbol definitions from Phase I that are relevant to 
Phase III processing, and provides a means of communicating between 
Phase I and the other phases of SYSGEN. SYSGEN creates this file in 
the directory from which you invoked Phase I of SYSGEN. 


SYSGEN replaces <uic> with the directory from which you invoked Phase 
III of SYSGEN. Enter a different directory to override this default; 
otherwise, press the RETURN key. 


Some tasks are not available on the baseline system (such as BAD). If 
you want to task build a nonprivileged task for the baseline system, 
use the SGNPARM.CMD file for the baseline system in directory [1,54]. 
* 2. Are you building nonprivileged tasks? [Y/N]: 


If you are building any of the following nonprivileged tasks listed, 
respond Yes to this question: 


BAD CMP EDI FTB PAT STK 
BRU CRF EDT TOX PIP TKB 
CDA DMP FLX LBR RPT VFY 
CFL DSC FMT MAC SLP ZAP 
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NOTE 


See the RSX-11M/RSX-11S Information Directory and 
Master Index to locate the appropriate documentation 
on these tasks. BRU is available only on mapped 
systems. EDT is available only on mapped systems with 
the full-duplex terminal driver. 


* 2A. Is this an RLO] kit? [Y/N]: 
This question applies only if you have an RLOI1/RLO2 distribution kit. 


SYSGEN uses your response to this question to determine the location 
in your distribution kit of the files for building nonprivileged 
tasks. (In an RLO1 kit, they are located on RLUTIL; on an RLO2 kit, 
they are located on PRVBLD.) 


* 3. Enter device for <label> disk when it is ready (ddu:) [D: <object>] [S]: 


This question appears only if you are using an RLO1/RLO2 distribution 
kit. 


To answer this question, enter the device mnemonic and unit number of 
the drive containing the requested object files disk. (SYSGEN 
replaces <label> with the volume name of the appropriate disk.) 


If you are using an RLO1 distribution kit and if you answered. No to 
Question 2, SYSGEN replaces <label> with PRVBLD. 


If you are using an RLO1 distribution kit and you answered Yes to 
Question 2, SYSGEN replaces <label> with RLUTIL. 


If you are using an RLO2 distribution kit, SYSGEN replaces <label> 
with PRVBLD. 


If you are using any other disk kit, SYSGEN replaces <label> with 
"object." 


The default response (<default>) is the response entered for Question 
17 of the Setup Section in Phase I. 


* 4. Enter map device (ddu:) [D: NL:]: 


Map listings are usually of little use if your target system is 
mapped. The map listings are more useful if your target system is 
unmapped and you need to determine the exact size of your tasks. 


If you want the map listings, specify the desired output device as 
your response. If you specify a device other than LP:, SY:, LB:, TI:, 
TT:, or NL:, the device must be mounted, and the directory [1,34] for 
mapped systems or [1,30] for unmapped systems must exist on the 
volume. 


The default output device for the map listings is WNL: (the null 
device). ; 


* 5. Enter task name(s) [S]: 


Enter the names of those tasks that you wish to build. If you’ intend 
to build more than one task, separate the names of the tasks with a 
comma. You need not enter all the task names on one line. When you 
have entered the names of all tasks to be built, enter a period (.) to 
terminate input. 
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If you want to build MCR for a multiuser system, enter MCM as the task 
name. 


If you answered Yes to Question 2 to indicate that you intend to build 
nonprivileged tasks, you may enter an asterisk (*) to display a table 
of the nonprivileged tasks. Likewise, you may enter a percent’ sign 
(%) to indicate that you want to build all of the nonprivileged tasks 
listed in the table. 


NOTE 


You may rebuild privileged tasks using SYSGEN3.CMD. 
However, you should not use Phase III for building all 
privileged tasks. If you intend to rebuild several 
(or all) privileged tasks, you should do so in Phase 
If. 


* 6. Use [1,1]FCSRES.STB when building those tasks? [Y/N]: 


If your target system includes the FCS resident library (FCSRES) and 


if you want your task(s) to link to that library, answer Yes to this 
question. 


If you answer No, any tasks built during Phase III are not linked to 
the FCS resident library. Instead, each task contains all of the 
necessary FCS modules within the task image. 


Tasks linked to the FCS resident library can only run on a system with 
that FCS resident library installed. Tasks built to link to FCSRES 
cannot run on the baseline system. 


This question does not appear if you did not select the FCS resident 
library (FCSRES) in Question 3 of the System Options Section in Phase 


* 7. Use LB: [1,1JANSLIB.OLB when building those tasks? [Y/N]: 


If your target system includes ANSLIB.OLB and if you want to build any 
tasks with ANSLIB, answer Yes to this question. 


This question appears only if you are building DMP, FLX, PIP, or VFY 
and if you selected ANSI magnetic tape support (Question 13 of the 
Executive Options Section in Phase I) or support for big buffering 
(Question 1 of the System Options Section in Phase I). 


If you answer No to this question, any tasks you specify to be built 
for your target system are built with SYSLIB.OLB. 


This question does not appear if your target system includes a 
resident FCS and does not include ANSLIB.OLB. See Question 3 of the 


System Options Section in Phase I for more information on the ANSI 
version of FCSRES. 


* 8. GEN's base address in 32 word blocks [0 D:400]: 


This question appears only for unmapped systems and only if you are 
building a task other than.MCR, PRT, TKTN, FCPMIN, or FCPSML. 


Enter the same base address for GEN that you specified in Phase II 
(Question 2 in the Privileged Task-Build Section). The base address 
for GEN starts on a 32(10)-word boundary. 
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The default of 400 is based on the assumption that the highest 
location in memory allocated to the Executive does not exceed 40000 
and that you intend to use nonprivileged tasks built to run in the GEN 
partition starting at location 40000 (for example, the default of 400 
is correct for standard unmapped systems) . 


* 9, SYSPAR's base address in 32 word blocks [0 D:<default>] 


This question appears only for unmapped systems and only’ if you are 
building MCR, TKTN, FCPMIN, or FCPSML. 


Enter the same base address for SYSPAR that you specified in Phase II 
(Question 3 of the Privileged Task-Build Section). If the target 
system has 24K words or more of memory, the default (<default>) is 
1300. The default is based on the assumption that you selected the 
default of 400 32(10)-word blocks for the GEN partition and that you 
plan to include a 14K task partition (PAR14K) of which GEN is an 8K 
subpartition. 


If the target system has fewer than 24K words of memory, the default 


base address is 1000. This default is based on the assumption that 
you have selected the default of 400 32(10)-word blocks for the GEN 
partition and that GEN is an 8K partition. 


The base address for SYSPAR starts on a 32(10)-word boundary. 
* 10. SPLPAR's base address in 32 word blocks [0 D:<default>]: 


This question appears for unmapped systems only, and only if you are 
building the serial despooler task (PRT). 


Enter the same base address for SPLPAR that you specified in Phase II 
(Question 4 of the Privileged Task-Build Section). 


The base address of SPLPAR starts on a 32(10)-word boundary. If you 
selected FCPMIN, the default response for this question can be 
calculated by adding 100 to the default base address of SYSPAR. 


If you selected FCPSML, the default response for this question can be 
calculated by adding 120 to the default of Question 10 above. 


* 11. Pause to edit any task build .CMD or .ODL files? [Y/N]: 


If you answer Yes to this question, SYSGEN pauses to allow you to 
selectively edit the task-build .CMD or .ODL files. This is the 
logical place in SYSGEN to alter any task-build parameters if you need 
to do so. If you choose to edit any .CMD files, the information to 
edit a given file is contained in comments within that file. 


* 12. Delete task build .CMD and .ODL files after task building? [Y/N]: 


It is not necessary to keep the .CMD and .ODL files after they have 
been used to build their respective tasks. They can be easily 
re-created by reinvoking SYSGEN3.CMD. You can free the disk space 
occupied by these files by answering Yes to this question. 
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Example 7-l: Annotated Terminal Output from SYSGEN Phase III 


@SYSGEN3 O 

< RSX-11M V4.2 System Generation PHASE III -- Version 2.05 

>; 14-JUN-85 13:29:15 | 

>* 1. In what UIC is SGNPARM.CMD if not in [200,200] [S]: 
; Big disk distribution kit SYSGEN version 2.10 for RSX-11M BL38 
3 Continuation from SYSGEN PHASE I done on 13-JUN-85 at 18:26:39 

>* 2. Are you building nonprivileged tasks? [Y/N]: Y 

>* 4, Enter map device (ddu:) [D: NL:] [S]: SY: 

>ASN SY:=LB: 


; For nonprivileged tasks: * -- Prints the table of tasks 


; % -- Builds all tasks 
; - -~ Terminates inquiry 


; Enter responses separated by commas. All responses need 
3; not fit on one line. 


; Example: BAD,LBR,PIP,.. 
>* 5. Enter task name(s) [S]: * @ 


; Nonprivileged tasks: 


>; BAD BRU CDA CFL CMP 
H CRF DMP DSC EDI EDT 
; FLX FMT FTB TOX LBR 
; MAC PAT PIP RPT SLP 
>; STK TKB VFY VMR ZAP 


>* 5. Enter task name(s) [S]: CDA. 9 


; (1,1]FCSRES.STB can be used to build many tasks 
: so that those tasks link to the FCS resident library 


>* 6. Use [1,1]FCSRES.STB when building those tasks? [Y/N]: Y 


; It is assumed that [1,1]FCSRES.STB is an ANSLIB version of the FCS 
; resident library 


; Note that tasks linked to the FCS resident library can only 
; run on a system with the FCS resident library installed. 


>* 11. Pause to edit any task build .CMD or .ODL files? [Y/N]: 
>* 12. Delete task build .CMD and .ODL files after task building? [Y/N]: . 
>SET /UIC=[1, 24] 


>; Creating the task build .CMD and .ODL files in Sy: {1,24] 


>TKL @SY:[1,24]CDARESBLD.CMD 
>ASN =LB: 

>SET /UIC=[200, 200] 

>@ <EOF> 

> 
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Notes for the terminal output from SYSGEN Phase III (for a mapped 
target system): 


1) Invokes Phase III. 


2) When you enter an asterisk (*) aS a response to Question 5, 
SYSGEN displays a list of the nonprivileged tasks that you 
can task build. 


3) Enter the names of the tasks you want task built for your 
target system, then terminate your input with a period. 


The system generation procedure is now complete. You may want to make 
some adjustments to your system after you have had some time to use 
it. Appendix D may help you to adjust the amount of pool space your 
system needs. In addition, the RSX-11M/M-PLUS System Management Guide 
may also help you to optimize your system's performance. 


All 


CHAPTER 8 


SYSGEN ERROR MESSAGES 


error messages from SYSGEN appear in this chapter in alphabetical 


order. The descriptions that follow each message explain the possible 
cause and, as necessary, suggest remedial action. 


SGN 


SGN. 


SGN 


SGN 


SGN 


-~- You attempted to use non-existent default for parameter <parm> 
-- RETRY 


Explanation: A required parameter was missing from the response 
to the current peripheral question. SYSGEN replaces <parm> with 
a number indicating the position in the prompt line of the 
missing parameter. Reenter the entire response. Note that the 
{L/R] parameter is not considered as one of missing parameters. 


-- Baseline terminal driver not valid option with multiuser 
protection selected 


Explanation: The half-duplex baseline terminal driver includes 
no SYSGEN options and cannot execute in a multiuser protection 
system (for example, the break-through write option is required 
but not included). Choose a different terminal driver. 


-- CO driver not valid on RSX-11S systems 


Explanation: RSX-11S systems cannot include the console driver 
(CO). SYSGEN ignores this entry. 


-- CO driver not valid on unmapped system 


Explanation: Unmapped systems cannot include the console driver 
(CO). SYSGEN ignores this entry. 


-~- Correct problems and reassemble the bad modules; SYSGEN will 
continue when done 


Explanation: This message indicates that you detected an error 
in the Executive or device drivers assembly (you responded No at 
either the Executive or driver EOX breakpoint). After you 
correct the error, reassemble the bad modules and SYSGEN 
continues. 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 
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~- Correct problems -- SYSGEN will restart assemblies when done 


Explanation: This message indicates that you detected an error 
in assembling the laboratory peripheral devices. After you 
correct the error, SYSGEN attempts to reassemble the laboratory 
peripherals common area(s). 


-- DM11-BB CSR address must be greater than 157777 if specified -- 
RETRY 


Explanation: If the system includes a DM11-BB, the CSR address 
must be greater than or equal to 160000. If DM11-BB is not 
included, the CSR address must be 0. 


-- DM11-BB vector address must be greater than 277 if specified -- 
RETRY 


Explanation: If the system includes a DM11-BB, the interrupt 
vector address must be greater than or equal to 300. If DM11-BB 
is not included, the vector address must be 0. 


-- DU not valid on an unmapped system ~-- SUPPRESSED 


Explanation: Unmapped systems cannot support the UDA50 (DU:). 
SYSGEN ignores this entry. 


-- Dynamic storage space must be in multiples of two words -- 
RETRY 


Explanation: The system allocates pool in four-byte sections. 
Thus, the amount of pool must be a multiple of four bytes. 


-- EDT only built for mapped systems with a full-duplex terminal 
driver 


Explanations You must be generating a mapped system with a 
full-duplex terminal driver to include EDT in your target system. 
Otherwise, SYSGEN does not build the task. 


-- FCP <fcp> not valid on an unmapped system -- RETRY 


Explanation: The FCP indicated is not available on unmapped 
systems. SYSGEN reprompts for a different FCP. 


-- File <file>.BLD does not exist 


Explanation: SYSGEN cannot find the specified task's .BLD file, 
which SYSGEN needs to dynamically create the .CMD and .ODL files 
for that task. 


-- GR not valid on system with more than 124K -- SUPPRESSED 


Explanation: The graphics display driver (GR) does not execute 
on 22-bit processors. If your system includes a GR, the maximum 
amount of memory is 124K. I£ you have a GR and want to use it, 
type CTRL/Z and restart your system generation specifying 124K or 
less for memory size. 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 
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-- Illegal character in numeric response -- RETRY 

Explanation: A character other than 0 through 7 for an _ octal 
response or 0 through 9 for a decimal response was entered. Note 
that the use of special characters (# or .) to indicate an 
explicit octal or decimal response is not allowed. 

-- Illegal device mnemonic -- RETRY 

Explanation: You specified a drive type that the device does not 
support (such as an RPO6 for a DL device). 


-- Illegal numeric answer -- RETRY 


Explanation: See the explanation of "Illegal character in 
numeric response." 


-- Illegal printer specification -- Valid types are LP11-A, B, C, 
D, -E, FEF, H, J, K, R, S, V, W, Y, Z, LS11, LA180, LNO1, and LV11 
-- RETRY 


Explanation: SYSGEN supports only the line printer controllers 
listed. If you have a different controller, refer to the 
Peripheral Options question concerning LP: to match your printer 
characteristics with a DIGITAL printer. 


-- Illegal trailing characters or extra parameters "parm" -- RETRY 
Explanation: You have specified more parameters than allowed for 
this response. Note that parameters in brackets can be specified 
only for the first controller of this type. 

-- Indirect Command Processor error encountered in <file>.BLD 
Explanation: SYSGEN encountered an error while processing the 
specified .BLD file. The .CMD and .ODL files created by the .BLD 
file may not have been created correctly. 

-- Input saved answer file <file> does not exist -- RETRY 
Explanation: Either the indicated input saved answer file does 
not exist or SYSGEN had a problem referencing the file. SYSGEN 
repeats Setup Question 8. 

-- Invalid directive code <directive-code> 
Explanation: You have entered a code other than A, B, C, D, E, 
F, G, H, I, J, K, or Le. The line is discarded. 

-- Invalid FCP code <fcp code> entered -- RETRY 


Explanations You have entered an FCP code other than A, B, C, D, 
or E. SYSGEN reprompts for a valid FCP code. 
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SGN -- Invalid processor type -- RETRY 


Explanation: You have entered an unknown processor type in 
response to Question 1 in the Target Configuration Section of 
SYSGEN Phase I. 


SGN -- Invalid system device -- RETRY 


SGN 


SGN 


SGN 


SGN 


SGN 


Explanation: The device specification for the Executive source 
disk was entered incorrectly. 


Big-disk kits: The default response is SY:. Either enter Y or 
press the RETURN key. Otherwise, you must enter at least two 
characters to identify the device that contains the Executive 
sources. 


RLO1 kits: There is no default response to this question. Enter 
at least two characters to identify the device that contains the 
Executive sources. 


-~- Listing files cannot be sent directly to LP: -- RETRY 
Explanation: Spooled listings must go to a spool device. Also, 


for on-line SYSGENs, maps cannot be spooled directly to the line 
printer. If you want to print at LP:, specify LPO:. 


-- Loadable driver support was not selected in the Executive 
section of SYSGEN. Device cannot be made loadable -- RETRY 


Explanation: You did not include loadable driver support in the 
system. All device drivers must be resident. 


-- Loadable/Resident indication not valid for this device -- RETRY 
Explanation: "Loadable" or "resident" is not an option for this 
device. 


-- Mapping option of the input saved answer file is different from 
the mapping option selected in Question 5 


Explanation: The mapping option that you specified in Question 5 
of the Phase I Setup Section conflicts with the mapping option in 
the input saved answer file. For instance, your response to 
Question 5 may indicate that you want to generate an unmapped 
system, but the input saved answer file indicates a mapped 
system. 


Reinvoke SYSGEN and select an input saved answer file that 
corresponds to the type of system (mapped or unmapped) that you 
indicated in Setup Question 5. 


-- Maps cannot be sent directly to line printer -- RETRY 
Explanation: Spooled maps must first go to a spool device. 


Also, for on-line SYSGENs, the maps cannot be spooled directly to 
the line printer. If you want to print at LP:, specify LPO:. 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 
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-- Maximum of 1 CRT monitor possible with VT11 -- RETRY 


Explanation: A VS60 can support two CRT monitors, but a VTll 
supports only one. 


-- Maximum of 8 printers allowed on a system with a KMC -- RETRY 


Explanation: The KMC-11 supports up through eight line printers. 


-~- Maximum of <nn>. controllers allowed for device dd -- RETRY 


Explanation: The specified device supports <nn> controllers. 
Note that pseudo devices can indicate only one controller. 
Terminal driver controllers are specified later. 


-- Memory management and loadable drivers options support needed 
to include DHV11 support 


Explanation: You tried to include DHV11 support without first 
including full-duplex terminal driver support (Question 1, Option 
C in the Terminal Driver Options Section) which requires memory 
management support (Question 5 in the Setup Section) and loadable 
drivers options support (Question 15 in the Executive Options 
Section). 


Restart SYSGEN using the saved answer file you just created 
($SA0) and include memory mangement support and loadable drivers 
support. 


-- Memory size inconsistent with mapping option 


Explanation: The maximum memory size for an unmapped system is 
28K words. The minimum memory size for a mapped system is 24K 
words. You have either specified more than 28K words of memory 
for an unmapped system (Question 3 in the Target Configuration 
Section) or fewer than 24K words of memory for a mapped system. 


-- Memory not multiple of 4K 

Explanations When you specify memory size, it must be a multiple 
of four. 
-- More than 252. modules specified -- RETRY 

Explanation: The UDCll supports a maximum of 252(10) modules. 
You have specified more than the maximum. 

-- Number of interrupts must be divisible into 10,000 

Explanations The number of interrupts per second specified for 
the KW11-P clock was not 1, 2, 4, 5, 8, 10, 16, 20, 25, 40, 50, 
80, 100, 125, 200, 250, 400, 500, 625, 1000, 1250, 2000, 2500, or 
5000. 


Note that more than 100(10) clock interrupts per second 
significantly increases system overhead. 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


SYSGEN ERROR MESSAGES 
-- Number of samples must be evenly divisible into 10000. -- 
RETRY 
Explanations: The sampling rate was not 1, 2, 4, 5, 8, 10, 16, 
20, 25, 40, 50, 80, 100, 125, 200, 250, 400, 500, 625, 1000, 
1250, 2000, 2500, or 5000. 


-- Overlapping modules -- RETRY 


Explanation: The last module specified attempts to use slots 
that you have indicated as occupied by other modules. 


Review your configuration and try again. 


-- Parameter (#n) <parm> out of range <min> to <max> -- RETRY 


Explanations The indicated parameter (excluding [L/R]) is not 
within the acceptable range. 


-- Pausing to allow editing of Executive source 


Explanation: This is not an error message; the message is 
informative. It appears when you indicate you want to edit the 
Executive files. 


-- Procedure can only be executed under the ICP.TSK version of the 
Indirect Command Processor 


Explanation: The Indirect Command Processor presently running is 
ICQ.TSK and has limited capability. SYSGEN exits under this 
condition. 


Remove AT., install ICP.TSK (the version of the Indirect Command 
Processor with the capability required for system generation), 
then reinvoke SYSGEN. 


-- Procedure can only be run from MCR or DCL 


Explanation: The indirect command file has been invoked from a 
user-written CLI. SYSGEN exits under this condition. 


Set your terminal to either MCR or DCL and reinvoke SYSGEN. 


-- Saved answer file for a Standard Function System (SGNSTAND.CMD) 
does not exist 


Explanation: Either the saved answer file SGNSTAND.CMD does. not 
exist in the current directory on the SY: disk or SYSGEN has a 
problem referencing it. SYSGEN repeats Setup Question 8 under 
this condition. 


-- Standard Function System requires at least 96K words of memory 
Explanation: You cannot generate the Standard Function System 
because the target system does not have sufficient memory. 


SYSGEN exits under this condition. 


Reinvoke SYSGEN, but do not choose the Standard Function System. 
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SGN -- String <string> ignored 
Explanation: The <string> portion of the response to Question 5 
of Phase III is invalid. SYSGEN ignores that part of your 
response. 

SGN -- SYSGEN encountered an unrecoverable error within the module 
<module> 
Explanation: SYSGEN encountered an unrecoverable error within 
the module <module>. 

Submit an SPR for the problem and include a hardcopy listing of 
the SYSGEN dialog as well as _ the saved answer file that was 
created from SYSGEN. 

SGN -- Task <task> is not built for unmapped systems 
Explanation: SYSGEN cannot build the indicated task for an 
unmapped system. The task is valid on mapped systems only. 

SGN -- The full-duplex terminal driver requires memory management and 
loadable driver support. If you desire the full-duplex driver, 
you must repeat the Executive questions and select these options. 
Explanation: As the message states, you must include memory 
management support and loadable driver support to select the 
full-duplex terminal driver. 

SGN -- Unit number must be an integer in the range 0 to 7 
Explanations The crash device must be a unit number from 0 
through 7. 

SGN -- Unrecognizable string "ddn" -- Ignored 
Explanation: SYSGEN could not parse the indicated string. 
Perhaps you omitted a comma. 

SGN -- Valid character detection expander unit indicators are "c" 
(yes) and "NO" (no) -- RETRY 
Explanation: Valid responses for this parameter are C to 
indicate that the controller includes a character unit and NO to 
indicate that it does not. 

SGN -- Valid D/A present indicators are "D" (yes) and "NO" (no) -- 
RETRY 
Explanation: Valid responses for this parameter are D_ to 
indicate that the controller includes a D/A converter and NO to 
indicate that it does not. 

SGN -- Valid devices: DT, DK, MT, MS, MM, DB, DM, DL, DD, DR, DU, DX, 


MU, and DY ~-- RETRY 


Explanation: The Executive crash module does not support’ the 
device you entered as a dump device. 
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SGN 


SGN 


SGN 


SGN 


SGN 
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-- Valid DR11-K present indicators are "DRK" (yes) and "NO" (no) 
-- RETRY 


Explanation: Valid responses for this parameter are DRK to 
indicate that DRI11-K is present and NO to indicate that it is 
not. 


-- Valid duplex indicators are "H" and "F" -- RETRY 

Explanation: Valid responses for this parameter are H_ to 
indicate a half-duplex line and F to indicate a full-duplex line. 
-- Valid error detection expander unit indicators are "E" (yes) 
and NO (no) -- RETRY 

Explanations: Valid responses for this parameter are E to 


indicate that the error detection expander unit is present and NO 
to indicate that it is not. 


-- Valid indicators are "H," "F," and "P" -- RETRY 


Explanation: Valid responses for this parameter are H_ to 
indicate a half-duplex line, P to indicate primary station of 
line, and F to indicate a full-duplex line. 


-- Valid graphic device indicators are "VT11" and "VS60" -- RETRY 


Explanation: Valid responses for this parameter are VT1l_ to 
indicate a VTll graphics display device and VS60 to indicate a 
VS60 graphics display device. 


-~- Valid line speeds are 50, 75, 110, 134.5, 150, 200, 300, 600, 
1200, 2400, 4800, and 9600 ~- RETRY 


Explanation: The DH11 controller does not support the specified 
line speed. 


-- Valid line speeds are 75, 110, 134.5, 150, 300, 600, 1200, 
1800, 2000, 2400, 4800, 9600, and 19200 -- RETRY 


Explanation: The DHV11 controller does not support the specified 
line speed. 


-- Valid offset recovery indicators are "0" (yes) and "NO" (no) -~ 
RETRY 


Explanation: Valid responses for this parameter are O to 
indicate that all controllers of this type support offset 
recovery and NO to indicate that none of the controllers of this 
type support it. 


-- WARNING -- Console terminal interface (YL) forced into system 
Explanation: RSX-11M requires a terminal interface for 
operation. You failed to specify a terminal interface in your 


system, so SYSGEN included the console terminal interface (YL) 
for you. 
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SGN -- WARNING -- CPU does not have switch register -- Get sense 
switch directive not included 


Explanation: The processor you specified does not have a_ switch 
register. Thus, you cannot use the Get Sense Switch directive. 


SGN -- WARNING -- Input saved answers for Phase <n> may be incomplete 


Explanation: The saved answer file presently being used _ for 
input to SYSGEN does not contain answers for all of the questions 
in either Phase I or Phase II. (The error message specifies the 
exact phase of SYSGEN that was preempted.) Therefore, SYSGEN 
prompts you for input to those questions that do not have saved 
responses. 


SGN ~- WARNING -- Null device forced into system 


Explanation: This message indicates that SYSGEN has forced the 
null device into your configuration. The null device is required 
to redirect data normally sent to either the system disk or the 
terminal driver (both of which your system does not include). 


APPENDIX A 


SAVED ANSWER SYMBOLS 


This appendix lists all of the possible symbols that could be created 
during SYSGEN and stored in your saved answer file. At some time, you 
May want to examine a previously generated saved answer file to see 
which options you included or excluded. 


Following each symbol listed below is a key indicating the exact 
SYSGEN section and question number associated with the symbol and the 
text of the specific SYSGEN question. The exact text of the question 
is not always given below when it is more helpful to expand the text. 


The legend below defines the keys used to identify the SYSGEN phase 
and question number associated with each symbol. For example, the key 
SO-4, following the symbol SFCP, indicates that the symbol SFCP is 
associated with Question 4 in the System Options Section of SYSGEN 
Phase I... 


Legend: 
S Setup Questions Section (Phase I) 
TC Target Configuration Section (Phase I) 
HC Host Configuration Section (Phase I) 
E _ Executive Options Section (Phase I) 
TT Terminal Driver Options Section (Phase I) 
so System Options Section (Phase I) 
EB Exec TKB Section (Phase ITI) 
DB Loadable Driver Build Section (Phase II) 
TB Privileged TKB Section (Phase II) 
V System VMR Section (Phase II) 
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Table A-1 
Definition of Saved Answer Symbols 


Symbol Key Definition 

SMAP Is the system mapped (True) or unmapped (False)? 

STPR TC-1 Processor Type 

SSWR TC-2 Does the processor have a switch register? 

STME TC-3 Memory size (in K-word blocks) 

SKSR TC-4 Include support for K-series devices? 

SEAE TC-5 Extended arithmetic element (KE11-A/B EAE) 
present? 

SF PP TC-6 Floating point processor (FP11) present? 

SFIS TC-7 Floating instruction set (FIS) present? 

SEIS TC-8 Extended instruction set (EIS) present? 

SPRO TC-9 Number of KW-11P clock interrupts per second 

SLIN TC-10° Line frequency: A-60Hz B-50Hz 

SWAT TC-11 KW1L1-Y Watchdog timer support? 

SMPR TC-12 Memory parity support? 

SCAH TC-13 Cache memory support? 

SHIV TC-14 Highest interrupt vector 

SDEV TC-15 Peripheral devices and number of controllers 

SDV2 TC-15 Peripheral devices and number of controllers 

$DV3 TC-15 Peripheral devices and number of controllers 

SLPR HC-1 Is a line printer available? 

SSPL HC-2 Spool assembly listings and Executive and driver 
maps? 

SPWI HC-3 Does the listing/map device have at least 120 
columns? 

SALD HC-4 Assembly listing file device 

SMPD HC-5 Map device for Executive and device drivers 

SDBM E-1 Include support for DBMS-11? 

SF11 E-2 Files-l1l ACP supported? 

SRMS E-3 RMS bucket locking (file sharing) and placement 
control? 


(Continued on next page) 
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Table A-1 (Cont.) 


Definition of Saved Answer Symbols 


Definition 


Nonresident tasks (task loader) supported? 
Loadable task loader supported? 

Executive common support? 

Memory management (PLAS) directives supported? 
Send/Receive By Reference directives supported? 
Get Mapping Context directive supported? 
Address checking supported? 

I/O rundown supported? 

Multiuser protection supported? 

ANSI magnetic tape support? 


On-line formatting (FMT) and diagnostic QIOs 
supported? 


Loadable device drivers supported? 

Is the default for drivers loadable or resident? 
Include asynchronous system trap (AST) support? 
Include Cancel Selective Marktime support? 


Support task termination and "Device not ready" 
messages? 


Support power-fail recovery? 


Support install, request and remove on exit (MCR 
RUN) ? 


Large (20K) Executive supported? 

Logical device assignment supported? 

Include support for error logging? 

Do you intend to include a user-written driver? 
Include the SGTWRD (Get Word) Executive routine? 
Include the SPTWRD (Put Word) Executive routine? 
Disk write-checking supported? 

Software write-locking supported? 


Executive Debugging Tool (XDT) supported? 


(Continued on next page) 


Symbol 


SROT 
SNET 
STSA 
SDMA 
SAMC 


SPRN 


$GGE 


SDRR 


SNPK 
SDTV 


SRRS 


SHIC 


SLOC 
SDKS 
SSWP 


SDSA 


SPNR 
SCRR 
SRSD 


SCHK 
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Table A-1 (Cont.) 
Definition of Saved Answer Symbols 


Key - Definition 

E-31 Rotating pattern in data lights supported? 

E-32 Communications products supported? 

E-32A Network Command Terminal support? 

E-33 System-controlled partitions supported? 

E-34 Include support for the Shuffler? 

E-35 Queue Manager and queued print spooler 
supported? 

E-36 Group global event flags supported? 

E-37 Supported system directives: 


See the documentation of Question 37 for the 
relationship between the directives and the 
associated letter codes. : 


E-38 Number of preallocated QIO packets 
E-39 Size of the data transfer vector in words 
E-40 Round-robin scheduling interval in ticks: 


A value of 0 excludes the round-robin 
scheduler. 


E-41 Highest priority class for round-robin 
scheduling 

E-42 Lowest priority class for round-robin scheduling 

E-43 Executive level disk swapping interval 

E-44 Swapping priority 

E-45 Size of the dynamic storage region (pool) in 
words 

E-46 Seconds between "Printer not ready" messages 

E-47 Seconds between "Card reader not ready" messages 

E-48 System crash register and stack dump device CSR 

E-49 Checkpointing? 


(Continued on next page) 
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Table A-1l (Cont.) 
Definition of Saved Answer Symbols 


Symbol Key Definition 

SDYN E-50 Checkpointing with system checkpoint file? 
SCRA E-51 Type of crash dump analysis: A-PANIC B-CDA 
SNOT E-52 CDA output notification device CSR 

SMDD E-53 CDA memory dump device mnemonic 

SMDC E-54 CDA memory dump device CSR 

SPDD E-55 PANIC memory dump device CSR 

SRTE E-56 RT-11 emulation support? 

STTY TT-1 Terminal driver desired: 


See the documentation for Question 1 for letter 
code and associated terminal driver. 


STMN TT-2 Unsolicited input timeout value in seconds 
SF RM TT-3 Pass form feeds directly to the terminal? 
SACR TT-4 Automatic carriage return/line feed? 

STCK TT-5 Task checkpointable during terminal input? 
SUSC TT-6 Unsolicited input character AST supported? 
SCNO TT-7 Write with CTRL/O cancellation supported? 
SBWS TT-8 Break-through write supported? 

SCNR TT-9 CTRL/R retype supported? 

SESC TT-10 Escape sequence handling? 

SMLC TT-11 Support for Get Multiple Characteristics? 
SSMC TT-12 Support for Set Multiple Characteristics? 
SGTD TT-13 Support for Get Terminal Driver Options? 
SHSM TT-14 Hold-screen mode supported? 

STRW TT-15 Transparent read/write supported? 

$SCC TT-16 Settable case conversion for input supported? 
SRAP TT-17 Support for read after prompt? 

SRNE TT-18 Support for read with no echo? 

SRST TT-19 Support for read with special terminator? 
SRUB TT-20 CRI rubout support? 
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Table A-1 (Cont.) 
Definition of Saved Answer Symbols 


Symbol Key Definition 

STHS TT-21 CTRL/S and CTRL/Q supported? 

STIB TT-22 Support for user terminal input buffering? 

SVTB TT-23 Support for variable-length terminal input 
buffering? 

$L30 TT-24 LA30P supported? 

-SHRE TT-25 Support hardware unrecoverable input error 
notification? 

SDIC TT-26 Support device-independent cursor positioning? 

SBBF so-1 ANSLIB.OLB desired for big buffering? 

SIP11 SO-2A Support for IP11 Industrial I/O Subsystem? 

SIPPF SO-2B Support for IP11 power-fail? 

SISA SO-2 Build the library of ISA FORTRAN industrial/lab 
routines? 

SFRL SO-3 Build the PLAS resident FCS? 

SFCP So-4 Code for FCP: 


See the documentation for Question 3 for letter 
code and associated version of FLIACP. 


SPMD SO-5 Postmortem Dump (PMD) supported? 

SRMD SO-6 Resource Monitoring Display task (RMD) 
supported? 

SPRT SO-7 Non-Queue Manager print spooler (PRT) supported? 

SDCL So-8 DIGITAL Command Language (DCL) supported? 

SNUC So-9 Number of user-written CLIs 

SPMT SO-10 Support for pool monitoring/low pool recovery 
(PMT) ? 

SNOD So-1l System name (six or fewer alphanumeric 
characters) 

SS PM SO-12 Do you want SPM-11l support? 

SLEM EB-1 List Executive map? 

SLDM DB-3 Device mnemonic for loadable driver maps 

SBAD DB-4 Build all selected loadable drivers into DRVPAR? 


SLDxN DB-5 Loadable driver two-character device mnemonic 


(Continued on next page) 
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Table A-1 (Cont.) 
Definition of Saved Answer Symbols 


Symbol Key Definition 

SLDxP DB-6 Loadable driver partition name 

$LDxB DB-7 Loadable driver x partition base address 

$PRM TB-1l Device mnemonic for privileged task maps 

SGPB TB-2 GEN's base address 

SSPB TB-3 SYSPAR's base address 

SPPB TB-4 SPLPAR's base address 

SEDF TB-5 Pause to edit any task-build .CMD or ODL files? 

SDFL TB-6 Delete task-build .CMD and .ODL files after task 
building? 

SERV v-1 Edit SYSVMR.CMD? 


APPENDIX B 


HARDWARE BOOTSTRAP PROCEDURES 


Bootstrapping a device involves using the central processor unit (CPU) 
console switches to initiate a hardware loader. The hardware loader 
contains machine instructions for reading a special record from the 
device. The record, called a bootstrap record, is transferred into 
memory and executes a specially designed software program. For the 
bootstrap operation to succeed, the device accessed must be on line 
and ready, the medium accessed must contain a proper bootstrap record, 
and the console terminal must be on line. 


The PDP-11 console switches and their use are described in the 
Processor Handbook. The bootstrap procedure that you should use 
depends on the type of hardware bootstrap device on the system. Table 
B-l summarizes the addresses needed to bootstrap each device. The 
detailed procedures to bootstrap a device are presented according to 
the types of hardware bootstrap devices available. 


B.1 GENERAL BOOTSTRAPPING PROCEDURE 


The following procedures give a general description of the steps 
necessary to hardware bootstrap a magnetic tape and ae disk, 
respectively. 


To bootstrap a magnetic tape: 

1. Physically mount the magnetic tape (for instance, the 
stand-alone BRU64K tape) on unit 0, with the write-enable 
ring removed. 

2. Ensure that the tape is at its load point. (The BOT 
indicator light comes on.) The CPU does not bootstrap the 
device unless the tape is at its load point. 


3. Set the ON-LINE/OFF-LINE switch on the tape unit to ON-LINE 
and ensure that the RDY (ready) indicator is lit. 


4. Ensure that the console terminal is on line. 


5. Follow the bootstrap instructions (in this appendix) for the 
particular bootstrap you must use. 


To bootstrap a disk: 


l. Insert the disk (for instance, the baseline disk RSXM38) ina 
free unit. 


2. Ensure that the RDY (ready) light is on. 
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3. Ensure that the console terminal is on line. 


4. Follow the bootstrap instructions (in this appendix) for 
particular bootstrap you must use. 


Table B-1l 
Summary of Hardware Bootstrap Addresses 


Device to Bootstrap Bootstrap Type 


the 


MR11-DB M9301-YA M9301-YB M9301-YC M9301-YF M9312 


RF1l disk 773100 

RS03/RS04 disk Ds DS 100 DS 

RKOS disk cartridge 

unit 0 773110 DK DK 30 DK 

RPO2 or RPO3 disk 

pack unit 0 773154 DP DP 40 DP 

RPO4, RPOS5, or RPO6 

disk pack unit 0 DB 70 DB DB 

RKO5 disk (unit n) DKn DKn 30+n DKn 
RLO1/RLO2 disk 

unit n 

RKO6 disk (unit n) DMn 


RKO7 disk (unit n) 


RPO2 or RPO3 disk 
pack (unit n) DPn DPn 40+n DPn 


RP04, RPOS, RPOG, 

RMO2, RMO3, RMOS5, 

RPO7, or RM80 

disk (unit n) DBn 70+n DBn 
RA60/80/81, RC25 

TK50 


TU1O/TE1O and TS03 
magnetic tape 773136 MT MT 10 MT 


TS11 magnetic tape 


TUL6/TE16/TU45 
/TU77 magnetic tape MM 60 MM 
TU56 DECtape 773120 DT DT 20 DT 


DS 


DK 


DP 


DKn 


DLn 


DMn 


DMn 


DPn 


DBn 
DUn 


MUn 


MTn 


MSn 


MMn 


DTn 
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B.2 MR11-DB PROCEDURE 


If the MR11-DB Bulk Storage Loader is on the system, perform the 
following steps: 


1. 


23 


Move the CPU console ENABLE/HALT switch to its HALT position 
and then back to its ENABLE position. 


Set the CPU switch register to one of the following values: 
773100 for RF11l disk 
773110 for RKOS disk cartridge 


773154 for RPO3 disk pack 
773136 for TU1O/TE10/TS03 magnetic tape 


Press the CPU LOAD ADRS switch. 


Press the CPU START switch. 


B.3 M9301-YA AND M9301-YB PROCEDURE 


If the M9301-YA or M9301-YB Bootstrap Terminator is on the system, 
perform the following steps: 


1. 


While holding down the CTRL switch, press the BOOT switch on 
the front of the CPU. 


The bootstrap prints the contents (in octal) of registers RO, 
R4, the stack pointer, and the program counter at the console 
terminal. It then prints a prompting character (S$). 


In response to the prompting character, type the 
two-character device code and the unit number of the device 
to be bootstrapped. Terminate your response by pressing the 
RETURN key. Table B-2 describes the device codes. 


Table B-2 
Device Codes for M9301-YA and M9301-YB Bootstraps 


Device Code 
TULO/TE10/TSO03 magnetic tape MT 
TUL6/TE16/TU45/TU77 magnetic tape 1 MM 
RKO5 disk cartridge DK 
RPO2/RP03 disk pack DP 
RP04/RP05/RP06/RM02/RM03 disk packl DB 
RS03/RS04 fixed-head disk+ Ds 


1. M9301-YB Bootstrap Terminator only. 
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B.4 M9301-YC PROCEDURE 


If the M9301-YC Bootstrap Terminator is on the system, perform the 
following steps: 


1. Move the CPU ENABLE/HALT switch to its HALT position and then 
back to its ENABLE position. 
2. Set the start address of 17765000 with the console switches. 
3. Press the CPU LOAD ADDR switch. 
4. Set the device unit number with switches 0 through 2. 
5. Set the device code for the device to be bootstrapped in 
switches 3 through 6. Table B-3 lists the device codes. 
Table B-3 
Device Codes for the M9301-YC Bootstrap 
Device Code 
TULO/TE10/TS03 magnetic tape 1 
RKO5 disk cartridge 3 
RPO2/RPO3 disk pack 4 
TUL6/TE16/TU45/TU77 magnetic tape 6 
RP04/RP05/RP06/RM02/RM03 disk pack 7 
RS03/RS04 fixed-head disk 10 
6. Ensure that switches 7 through 21 are off (down). 
7. Press the CPU START switch. 


NOTE 
Before the M9301-YC Bootstrap Terminator actually 
bootstraps the system, it performs CPU tests, 
instruction and addressing tests, and memory and cache 
tests. If a hardware failure is detected, the 
diagnostic program halts. The lights contain the ROM 
address of the halt. If this occurs, call your 


DIGITAL Field Service representative. 


It may, however, be possible to continue with the 
bootstrap operation if the lights contain the address 
1773764, which indicates a cache failure. To continue 
in this case, press CONT. This is the only case in 
which it is possible to continue bootstrapping after 
the diagnostic test detects an error. 


HARDWARE BOOTSTRAP PROCEDURES 


B.5 M9301-YF PROCEDURE 


If the M9301-YF Bootstrap Terminator is on the system, perform the 
following steps: 


1. While holding down the CTRL switch, press the BOOT switch on 
the front of the CPU. 


2. The bootstrap prints the contents (in octal) of registers RO, 
R4, the stack pointer, and R5 at the console terminal. It 
then prints a prompting character (S$). 


3. In response to the prompting character, type the 
two-character device code and unit number of the device to be 
bootstrapped. Terminate your response by pressing the RETURN 
key. Table B-4 lists the device codes. 


Table B-4 
Device Codes for the M9301-YF Bootstrap 


Device Code 
TULO/TE10/TS03 magnetic tape MT 
TU1L6/TE16/TU45/TU77 magnetic tape MM 
RKO5 disk cartridge DK 
RKO6/RKO7 disk cartridge DM 
RPO2/RPO3 disk pack DP 
RP04/RP05/RP06/RM02/RM03 disk pack DB 
RS03/RS04 fixed-head disk DS 


B.6 M9312 PROCEDURE 


The M9312 Bootstrap Terminator contains independent programs that can 
bootstrap programs into memory from a selected peripheral device. 
Through front-panel control or following power-up, the computer can 
execute a bootstrap directly without manual keying of the initial 
program. The M9312 contains four sockets for peripheral bootstrap 
loader programs encoded in ROMS. The choice of ROMs is determined by 
the system configuration. 


After execution of the CPU diagnostics, the M9312 turns control of the 
system over to the user at the console terminal. The system prints 
out status information and is ready to accept simple user commands for 
checking and modifying information within the computer, starting a 
program already in memory, or executing a device bootstrap. 


If the M9312 Bootstrap Terminator is on the system, perform one of the 
following procedures: 


e If you have the M9312 Console Emulator on the system, follow 
the procedures in Section B.6.1. (PDP-11/60s and PDP-11/70s 
usually do not have console emulators.) If that procedure does 
not work, perform the next step to verify that you have a 
console emulator. 


B-5 
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If you have a CPU equipped with switch registers and do not 


know what devices the M9312 will boot, perform the procedures 
in Section B. 


If you have a CPU equipped with switch registers, know what 
device ROMs are on the M9312 Bootstrap Terminator, but do not 
have a console emulator, follow the procedures in Section B. 


If you do not have the M9312 Bootstrap Terminator on your 
system and need to boot the RLO1, RLO2, or RKO7 disk device, 
perform the manual load routine described in Section B.7. 


B.6.1 Using the M9312 Console Emulator 


The M9312 Console Emulator can be initiated in two ways depending on 
the type of CPU (push button or switch register) on the sytem. 


B.6.1.1 
1. 


Push-Button Boot Using the M9312 Console Emulator - 


While holding down the CTRL button, press the BOOT button on 
the CPU. 


The bootstrap prints the contents (in octal) of registers RO, 
R4, the stack pointer, and R5 at the console terminal. It 
then prints a prompting character. 


In response to the prompting character, type the 
two-character device code and the unit number of the device 
to be bootstrapped. Terminate your response by pressing the 
RETURN key. If the unit number is not entered, it is assumed 
to be zero. Table B-5 lists the device codes. 


Switch Register Boot Using the M9312 Console Emulator - 


Move the CPU console ENABLE/HALT switch to its HALT position 
and then back to its ENABLE position. 


Set the CPU switch register to 765020. 


Press the START switch. The bootstrap prints the contents 
(in octal) of registers RO, R4, the stack pointer, and R5 at 
the console terminal. It then prints a prompting character 
(@). 


Table B-5 
Device Names and Mnemonics 


Device To Octal 
Be Booted Mnemonic Unit Data 
RLO1 DL 0-3 042114 
RKO6/RKO07 DM 0-7 042115 


(Continued on next page) 


2. 
3. 
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Table B-5 (Cont.) 
Device Names and Mnemonics 


Device To Octal 
Be Booted Mnemonic Unit Data 
RxOl DX 0-1 042130 
RX02 DY 0-1 042131 
RS03/RS04 DS 0-7 042123 
RP02/RP03 DP 0-7 042120 
RP04/RP05/RP06 DB 0-7 


RM02/RM03/RMO05 DR 


RM80/RP07 pB 1 

RA60/RA80 DU 

RA81/RC25 DU 0-7 042125 

RKO03/RKO5 DK 0-7 042113 

TU55/TU56 DT 0-7 

TSll MS 0-7 046523 

TU1L6/TE16/ MM 0-7 046515 

TU45/TU77 MM 

TULO/TE10O/TSO3 MT 0-7 046524 

Console Emulator A0 N/A 040460 

CPU ROM 

Diagnostic ROM BO N/A 041060 

PDP-11/60/70 177776 
xXxX777 2 

Type DB rather than DR if you are booting the RM02, 


RMO3, RMO5, RM80, or RPO7 disk. 
This is a continuation ROM of a multiple ROM boot. 
Bad ROM or NO ROM present. 
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4. In response to the prompting character, type the 
two-character device code and the unit number of the device 
to be bootstrapped. Terminate your response by pressing the 
RETURN key. The prompting character returns at this point if 
the correct boot ROM was not installed or if a nonexistent 
device code is entered. If the contents of registers RO, R4, 
the stack pointer, and R5 appear before the prompting 
character, this indicates that at least one boot ROM socket 
is empty and it can accommodate another boot ROM. 


If the unit number is not entered, it is assumed to be zero. 
Table B-5 lists the device codes. 


Successful completion of the switch register bootstrap 
procedure produces header information on the console 
terminal, similar to the example given for the Push-Button 


Boot. After the message appears, begin the system generation 
process. 


B.7 BOOTSTRAP LOAD PROGRAM FOR THE RLO1/02 AND RKO7 


To bootstrap an RLO1, RLO2, or RKO7 device when the system does not 
have the M9312 Bootstrap Terminator, you must manually enter a 
bootstrap load routine using the CPU console. The following procedure 
describes the manual load process for the PDP-11/34 (a similar 
procedure is followed using the CPU LOAD ADRS, DEP, and EXAM switches 
for the PDP-11/70 computer): 


1. While holding down the CTRL button, press the HLT/SS_ button 
on the CPU. 


2. Set address 1000 in the console register by using the 
numbered console buttons. 


3. Press the LAD (load address) button. 
4, Press the CLR button to clear the register. 


5. Load the contents that appear in Table B-6 into memory using 
the numbered buttons and the DEP button. Press the CLR 
button after you have placed the contents in the CPU register 
and pressed the DEP button. 


After the contents are loaded, perform the following steps: 


1. Set address 1000 in the console register again by using the 
numbered buttons. 


2. Press the LAD (load address) button. 


3. While holding the CTRL button down, press the START button on 
the CPU to boot the device. 


You can verify the accuracy of the load routine by using the CPU EXAM 
button. Set address 1000 in the console register and press the LAD 
button. Press the EXAM button to reveal the contents of address 1000. 
It should be 12700 for both the RLO1, RLO2, and RLO7 routines. 
Continue to press the EXAM button to check the contents of the 
remaining addresses in the load routine. Use the LAD and the DEP 
buttons to correct any erroneous contents. 
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Table B-6 
RLO1/02 and RKO7 Load Routines 


RLO1/RLO2 RKO7 

Bootstrap Bootstrap 

Routine Routine 
Address Contents Contents 
1000: 12700 12700 
1002: 174400 177440 
1004: 12760 12760 
1006: 13 o? 
1010: 4 10 
1012: 12701 12701 
1014: 42 2003 3 
1016: 10110 10110 
1020: 105710 105710 
1022: 100376 100376 
1024: 12760 12760 
1026: 177601 177400 
1030: 4 2 
1032: 5721 62701 
1034: 10110 16 
1036: 105710 10110 
1040: 100376 105710 
1042: 12760 100376 
1044: 177400 5710 
1046: 6 100001 
1050: 5060 0 


l. Select drive number 0 through 7 for the RKO7. 

2. Load 4 for unit 0, 404 for unit 1, 1004 for unit 2, and 1404 
for unit 3. 

3. Load 3 for RKO6. 
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Table B-6 (Cont.) 


RLO1/02 and RKO7 Load Routines 


Address 


1052: 
1054: 
1056: 
1060: 
1062: 
1064: 
1066: 
1070: 
1072: 
1074: 


RLO1/RLO2 RKO7 
Bootstrap Bootstrap 
Routine Routine 


Contents Contents 


4 5007 
62701 

6 

10110 

105710 

100376 

5710 

100001 

0 

5007 


B.8 BOOTSTRAP LOAD PROGRAM FOR THE TU10, TE10, OR TSO3 


To bootstrap a TU1O/TE10/TSO3 magnetic tape when the system does not 
bootstrap that handles it, you must manually enter a load 
into memory using the CPU console switch register and the DEP 


have a 


routine 
switch. 


To load 


the routine, perform the following steps: 


Move the CPU console ENABLE/HALT switch to its HALT position 
and then back to its ENABLE position. 


Set the CPU switch register to 010000. 


Press the CPU LOAD ADRS switch. 


Load the following contents into memory using the Switch 
Register and DEP switch. 


Address 
010000 
010002 
010004 
010006 
010010 


010012 


Contents 
012700 
172524 
005310 
012740 
060011 


105710 
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Address Contents 
010014 100376 
010016 005710 
010020 100767 
010022 012710 
010024 060003 
010026 105710 
010030 100376 
010032 005710 
010034 100777 
010036 005007 


5. Set the console switch register to 010000. 
6. Press the CPU LOAD ADRS switch. 
7. Press the CPU START switch. 


If the system reads the tape but halts at address 010034, the magnetic 
tape generated a parity error. Try another drive and make it unit 0. 
If the system appears to take no action and halts, verify the accuracy 
of the routine by using the CPU console EXAM switch. Use the switch 
register and the DEP switch to correct any erroneous contents. Rewind 
the tape to its load point before executing the routine again. If no 
recovery is successful, you should have a DIGITAL Field Service 
representative check the device. If the hardware is working properly, 
you should use a new magnetic tape reel. 


This appendix is a table of RSX-11M devices. 


mnemonic, 


Mnemonic 


AD 
AF 
AR 
CR 
CT 
DB 
DD 
DF 
DK 
DL 
DM 
DP 


DR 


DS 


DT 
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RSX-11M DEVICES 


Table C-1l 
RSX-1L1M Devices 


Device 


Analog-to-Digital Converter 


Analog-to-Digital Converter 


Laboratory Peripheral Subsystem 


Card Reader 

TU60 Cassette 

RP04/05/06 disk drive 

TU58 DECtape II 

RF1ll disk drive 

RKO5/J/F cartridge disk drive 
RLO1/RLO2 disk drive 

RK06/07 cartridge disk drive 
RP02/03 disk drive 


RM02/03/05 disk drive 
RM80/RP07 fixed media 


RS03/04 fixed-head disk drive 


TU56 DECtape 


lists the device 


the device type, and the associated device controller. The 
bottom section of Table 1 lists the pseudo devices. 


Hardware Controller 


ADO1-D 
AFC11 

AR11 
CR11/CM11-E 
TALL 
RH11/RH70 
DL11 

RF11 

RKil 
RL11/RLV11/RL21/RLV21 
RK611/RK711 
RP11/RP11C 


RH11/RH70 
RH70 


RH11/RH70 


TCll 
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Table C-1 (Cont.) 
RSX-LIM Devices 


Hardware Controller 


Mnemonic Device 
DU RA60 removable media UDA50/KDA50-Q 
RA80/81 fixed media UDA50/KDA50-Q 
RC25 fixed/removable media RC25 
RD51 fixed media RQDX1 
RD52 fixed media RQDX1 
RD53 fixed media RQDX3 
RX50 diskette RQDX1/RUX50 
RX180 IBM-compatible diskette RUX50 
DX RX01 diskette drive RX11 
DY RX02 diskette drive RX211/RXV21/RXV12 
EM ML11 Nonrotating Electronic Memory RH70 | 
GR Graphics Display Processor and Scope VT11/Vvs60 
IC Industrial Control Subsystem ICR/ICS11 
IS Industrial Control Subsystem DRS/DS11 
LA Laboratory Peripheral Accelerator LPA11-K 
LP Line Printer LA1L1/LP11/LS11/LV11 
LS Laboratory Peripheral Subsystem LPS1ll 
MM TU45/TU16/TE16/TU77 magnetic tape drive RH11/RH70/TM02/TM03 
MS TS11/TSVO5/TU80 magnetic tapes TS11 
MT TS03/TU1O/TE1O magnetic tape drive TM11/TMA11/TMB11 
MU TK50 streaming cartridge tape TQK50 
PP Paper Tape Punch PC1l1 
PR Paper Tape Reader PC11/PR11 
UD Universal Digital Controller UDC11 
XB Interprocessor Link DA1LI1-B 
XE UNIBUS Ethernet Controller DEUNA 
XL Interprocessor Link DL11-E 
XM Interprocessor Link DMC11-E/DMR11 
XP Synchronous Interface DP1l 
XQ Synchronous Interface DQ1L 
XU Synchronous Interface DU11 


(Continued on next page) 


Mnemonic 


XW 
YH 
YJ 
YL 
YV 


YZ 


Mnemonic 
CL 
Co 
LB 
NL 
SY 


TI 
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Table C-1 (Cont.) 
RSX-11M Devices 


Device 


Synchronous Interface 

Asynchronous Terminal Interface 
Asynchronous Terminal Interface 
Asynchronous Terminal Interface 
Asynchronous Terminal Interface 


Asynchronous Terminal Interface 


Pseudo Device 

Console Listing Pseudo Device 
Console Output Pseudo Device 

Library Default Pseudo Device 
Null Device 

System Default Pseudo Device 


Terminal Input Pseudo Device 


Hardware Controller 


DUP11 

DH11 

DJ1l 
DL11/A/B/C/D/E/J /W 
DHU11/DHV11 


DZ11/D2ZQ11/DZV11 


Hardware Controller 
N/A 
N/A 
N/A 
N/A 
N/A 


N/A 
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FUNCTIONS IMPACTING POOL (DYNAMIC MEMORY) 


Use the following information when calculating the amount of pool 
(dynamic memory) to allocate during Phase I of SYSGEN. Section D.1l 
describes the common functions and Section D.2 describes the real-time 
functions. 


D.1 


COMMON FUNCTIONS 


Tasks 


Each task installed in the system requires at least 25(10) words 
for a Task Control Block. 


I/O Requests 


Send 


Each I/O request results in the allocation of an 18(10)-word I/0 
packet, which is queued to the appropriate device driver. 


Data and Send By Reference Message 
Each Send Data or Send by Reference message sent to ae task 


results in an 18(10)-word message packet being allocated to hold 
the requisite data. 


Partitions and Subpartitions 


Open 


Each main partition and subpartition requires a Partition Control 
Block of at least 18(10) words to describe its memory. In 
addition, for each active task, fixed task, and loaded driver in 
a system-controlled partition (whether the tasks are checkpointed 
or in memory), a PCB is built and allocated in the dynamic 
storage region. 


Files on Files-11l Disks 


Each open disk file requires a File Control Block for each file 
header. However, only one FCB is required, no matter how many 
accessors there are to a particular file. The size of an FCB is 
22(10) words. If FL11lACP has sufficient buffer space, the FCB 
will be contained within the task address space. 


Open 
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Each accessor to a disk file requires a window block. (Each LUN 
that has a file open counts as a separate accessor.) The size of 
a window block varies depending on a number of factors: 


e The fixed portion of the window block is 7(10) words’ for 
RSX-11M. 


e The variable portion of the window is the window size times 
3(10) words. 


e The window block is rounded up to the next 2(10)-word boundary 
for RSX-11M. 


The window size is determined when the file is accessed from: 
e The value specified when the file is accessed 

e The value specified when the volume was mounted 

@ The value specified when the volume was created 


e If none of the previous values were specified or are 
unreasonable, then a value of 7 is used. 


A value of -l has special significance. The window size is 
determined by the number of pointers required to map all of the 
file, with a limit of about 100(10) words. The typical window 
size is 28(10) words. 


If block locking is enabled, each lock requires a primary 
pool-lock block. The size of this lock block is 4(10) words. An 
initial entry is allocated when the file is first accessed with 
locking enabled. Additional entries are allocated as required 
when the I/O takes place. Lock blocks are released only when the 
file is no longer accessed. (Thus, a cache of lock blocks is 
available for quick use.) 


Files on Labeled or Unlabeled Tapes 
The window block is included in the Volume Control Block  (VCB) 


and, consequently, no additional pool is required when a file is 
accessed. There is no FCB equivalent. 


All Mounted Volumes 


Each mounted system volume and each mounted private volume 
require a control block in a system-wide list of mounted volumes. 
Each shared mounted volume requires a control block for each 
separate user. The size of this block is 4(10) words. 


Mounted Files-1l1 Disk Volumes 


Each mounted disk volume requires a Volume Control Block (VCB). 
The VCB is 28(10) words long. In addition, each header of the 
index file requires an FCB, normally only one at 22(10) words. 
This FCB will be allocated in the F11ACP's internal pool if 
possible. A window block is allocated for the index file. See 
the discussion on sizes and locations of file windows. 
Additional FCBs will be allocated as needed for the fast 
directory access cache controlled by the MOUNT /LRU or /ACCESSED 
keywords. 


FUNCTIONS IMPACTING POOL (DYNAMIC MEMORY) 


Mounted Labeled and Unlabeled Tapes 


Each file-structured tape set requires a single Volume Control 
Block (regardless of the number of units or tapes), a Mounted 
Volume List (MVL) entry for each device unit, and an Unmounted 
Volume List (UVL) entry for each two-tape volume in the tape 
volume set. The size of the VCB is 70(10) words, the MVL is 
8(10) words, and the UVL is 8(10) words. 


Foreign Mounted Disks and Tapes 


Each tape or disk mounted foreign requires only a short VCB. The 
size of this VCB is 10(10) words. 


Clock Queve Entries 


Each clock queue entry requires 8(10)words. These entries 
represent marktime, schedule, and periodic scheduling requests. 


AST-Related Processing 


Each power-fail, receive, and floating-point processor AST 
trap-enable for active tasks requires 8(10) words for an AST 
control block. Half-duplex and full-duplex terminal drivers 
allocate 14(10)-word blocks for single-character ASTs. At any 
point in time, the full-duplex terminal driver will have only one 
AST outstanding on a given terminal, whereas the half-duplex 
terminal driver could have several. 


I/O Buffers 


Card 


Task 


With the full-duplex terminal driver, output is buffered in the 
terminal driver before it is transferred to the user buffer. 
Each solicited and unsolicited input request requires a 
42(10)-word input buffer for half-duplex terminal drivers and 
successive 20(10)-word blocks, as needed, for the full-duplex 
terminal driver. 


Images 


Card images read from the CM/CR11 are buffered by the card reader 
driver before the driver transfers the information to the user 
buffer. Binary output requires an 80(10)-word buffer, whereas 
ASCII input requires a 4(10)-word buffer. 


Headers 


In a mapped system, the task header is copied into a block of 
memory allocated from the dynamic storage region. The standard 
task header size for each task in memory (that is, in execution 
and not checkpointed or inactive and fixed) is 62(10) words with 
a default of six LUNS and one window block. You can specify up 
through 250 logical units for a task (2 decimal words per logical 
unit) and 7(10) window blocks (8 decimal words per window block). 
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It is possible that a task with many LUNs and window blocks could 
use all the available dynamic memory. If the loader fails to 
load such a task (that is, fails to allocate the header for that 
task), the loader tries to checkpoint any tasks waiting to be 
checkpointed to free adequate contiguous pool space. If enough 
contiguous pool space does not become available for the large 
task header, all tasks currently running continue to run, but no 
tasks can be loaded. 


Data Bases for Loadable Drivers 


Data bases that are loaded into a system with a loadable driver 
require the amount of memory equal to the size of the data base. 


Loadable Drivers 


Loadable drivers on a mapped system require space for interrupt 
linkage as follows: 


e 14(10) words per interrupt entry for single-controller, 
non-error-logging drivers 


@ 22(10) words per interrupt entry for multicontroller, 
non-error-logging drivers 


@e 14(10) words for the first (or only) interrupt entry for 
error-logging drivers, plus 6(10) words for each additional 
interrupt entry for error-logging drivers 


Checkpointing 


Systems with dynamic checkpoint space allocation require 8(10) 
words to describe each checkpoint file and 8(10) words for each 
task checkpointed to a checkpoint file. 


Memory Management Directives 


Systems supporting the memory management (PLAS) directives 
require 6(10) words per task (active or fixed) for each region a 
task is attached to. This includes the task region and all 
static and dynamic commons. 


Connect to Interrupt Directive 


Systems supporting the Connect to Interrupt directive require 
22(10) words for each Interrupt Transfer Block (ITB) used for 
each interrupt vector serviced by a Connect to Interrupt 
directive. 


Error Logging 


Variable-length packets are allocated for each logged error that 
has not been serviced by the Error Logger. Error limiting 
protects pool from being flooded by a sudden burst of device 
errors. (See the RSX-11M/M-PLUS Error Logging Manual.) 
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D.2 REAL-TIME FUNCTIONS 


LPS1l1 (Laboratory Peripheral Subsystem) and AR11 (Analog Real-time 
System) 


Each LPS11/AR11 synchronous function requires 20(10) words for a 
secondary control block. 


ICS/ICR11 (Industrial Control Subsystem/Industrial Control Remote) 


Each task linked to ICS/ICR interrupts requires 16(10) words of 


dynamic memory, plus 6(10) words for each additional interrupt 
linkage. 


DRS/DSS11 (Industrial Control System Modules) 
Each task linked to DRS/DSS interrupts requires 9(10) words of 
dynamic memory, plus 5(10) words for each additional interrupt 
linkage. 

LPA11 (Laboratory Peripheral Accelerator) 
For the duration of every transfer, 10(10) words of dynamic 
memory are allocated for UNIBUS Mapping Register (UMR) mapping 
work space. 
For a Request Data Array (RDA), see the LPA-1l documentation. 
For the duration of every transfer in which an AST (asynchronous 


system trap) is specified, 6(10) words of dynamic memory are 
allocated for an AST block. 


APPENDIX E 


ADDRESS AND VECTOR ASSIGNMENTS 


Specific algorithms exist for assigning UNIBUS addresses and interrupt 
vector addresses to all devices attached to PDP-1l hardware. UNIBUS 
addresses and interrupt vector address assignments are either floating 
or fixed. 


If a device has a floating address assignment, the presence or absence 
of any floating address device affects the assignment of addresses to 
other floating address devices. Similarly, many devices have floating 
vector addresses. 


According to the algorithm, interrupt vectors must be assigned in a 
specific sequence and the presence of one type of device affects the 
correct assignment of interrupt vectors of other devices. If a device 
has a fixed address or vector, its location is unaffected by other 
devices on the system. 


This appendix presents the algorithms for assigning floating addresses 
and vectors. It also lists the fixed assignments for devices 
supported by the Autoconfigure task. DIGITAL recommends that _ the 
hardware follow the configuration rules. 


E.1 AUTOCONFIGURE DEVICE SUPPORT 


Table 1 lists the devices supported by autoconfiguration. This list 
is only a subset of the devices supported by RSX-11M. The complete 
list of devices supported by RSX-11M can be found in Appendix C or in 
the RSX-11M Software Product Description. 


As stated previously, many devices have floating CSR addresses. A 
complete description of the algorithm used to determine these CSR 
addresses can be found in Section E.2. 


Table 1 also contains those devices that have floating vectors. These 
devices can be identified by a ranking priority under the vector 
label. The floating vectors begin at address 300 and _ proceed 
continuously upwards. 


Gaps in the vector assignments are not’ required. The vector 
assignment sequence is done based on ascending vector ranking. That 
is, the device with the lowest rank is assigned the next floating 
vector address. The autoconfiguration process dynamically computes 
the vectors of all supported devices. This is done by forcing each 
present device to interrupt. 


ADDRESS AND VECTOR ASSIGNMENTS 


The headings for the table indicate the following information: 


"Device" denotes the device being autoconfigured. 
"CSR" denotes the CSR address for the device. 


"Reg. Size" denotes register size, expressed in octal number of 
bytes. 
"Ist Vector" denotes the location of the first vector for the 
device. 
"Ctrl (max)" denotes the maximum number of controllers allowed 
for the device. 
"Int. Pri." denotes the interrupt priority for the device. 
Table E-1 
Autoconfiguration Device Support 
Device CSR Reg. Size 1st Vector Ctrl (max) Int. Pri. 
TA1L 177500 4 260 1. 6 
TUS8 (on a DL11) 176500 10 300 4. 5 
RK11 177404 20 220 12 5 
RL11/RL211 174400 20 160 1. 5 
RK611/RK711 177440 40 210 1. 5 
RP1ll 176714 40 254 l. 5 
TCll 177342 20 214 1. 6 
UDA50/RODX1/RC25 172150 4 154 1. 5 
RX11/RX211 177170 10 264 Ls 5 
RH11/RH702 172040 40 204 1: 5 
RH11/RH70 3 172440 40 224 ee 5 
RH11/RH70 4 176300 100 150 1 5 
RH11/RH70 (ML11) 176400 54 204 1. 5 
RH11/RH70 ” 176700 54 254 1. 5 
TM11 172522 20 224 1. 5 
TS11 172522 4 224 4 5 
LP/LS/LV11 (LPA) 177514 10 200 1. 4 
LP/LS/LV11 (LPB) 164004 10 170 is 4 


l. 
2. 
3. 
4. 
5. 


All MSCP devices. 
RS03/RS04. 
TU16/45/77, TE16. 


RS/RP/RM/TU alternate. 
RP04/05/06 or RM02/03/05. 


(Continued on next page) 


E-2 


ADDRESS AND VECTOR ASSIGNMENTS 


Table E-l (Cont.) 
Autoconfiguration Device Support 


Device CSR Reg. Size 1st Vector Ctrl (max) Int. Pri. 
LP/LS/LV11 (LPC) 164014 10 174 i 4 
LP/LS/LV11 (LPD) 164024 10 270 1% 4 
LP/LS/LV11 (LPE) 164034 10 274 Le 4 
LP/LS/LV11 (LPF) 164044 10 774 1.5 4 
LP/LS/LV11 (LPG) 164054 10 770 1. 4 
LP/LS/LV11 (LPH) 164064 10 764 i, 4 
PR11 177550 4 070 Ls 4 
PC1l 177554 4 074 i 4 
DH11 FLOAT 20 Rank 16 16. 5 
DL11-A/B/J 176500 10 Rank 2 16. 5 
DL11-C/D/E 175610 10 Rank 14 31. 5 
DL11-w® 177560 10 060 Ls 4 
DM11-BB 170500 ~=10 Rank 6 16. 5 
DZ11 FLOAT 10 Rank 28 16. 5 


6. Console terminal. 


E.2 FLOATING ADDRESS ASSIGNMENT ALGORITHM 


The following is the algorithm used to assign CSR addresses to all 
devices that have floating addresses. The autoconfiguration process 
finds only the devices listed in Table 1. If the system contains 
devices not listed, you must configure them manually. 


The floating address space starts at 760010 and proceeds upward to 
764000. 


A gap in the address space (there is no SLAVE SYNC signal on the _ bus) 
implies that a device does not exist. 


The first address of a new type of device will always be on a 2n-word 
boundary, where n is the first integer greater than or equal to LOG m 
and m is the number of device registers. 


ADDRESS AND VECTOR ASSIGNMENTS 


Number of Registers 

in Device Possible Boundaries © 

1 Any word 

2 | XXxXxxO, xxxxx4 

3,4 Xxxxx0 

5,6,.7;8 xxxx00, xxxx20, xxxx40, xxxx60 
9 through 16 xxxx00, xxxx40 


A gap of at least one word will be left after each type of device, 
starting on the same boundary the device would start on. Note that 
the gap must be at least one word but may be longer than one word. 
Gap length is determined by the boundary on which the next device must 
be addressed contiguously. 


Address 760010 is reserved for the first DJ11. Since the DJ1ll_ has 
four registers, additional DJlls are assigned addresses modulo 10 
(base 8) immediately following the first DJ1l1l (that is, 760010, 
760020, and the like.) The modulo 10 (base 8) address following the 
last DJ1l is left empty and is known as the DJ1l gap. If there are no 
DJlls, the gap is at 760010. If there is one DJ11, the gap will be at 
760020. All gaps must be at least one word. 


After all DJ11 addresses and the DJ1l gap are defined, the address for 
the first DH11 can be assigned. DH1ls have eight registers, which 
implies a modulo 20 (base 8) boundary. The address of the first DHI11 
is the first modulo 20 address following the DJ1l gap. If there are 
no DJlls (DJ11 gap at 760010), the first DH11l is assigned address 
760020. Similarly, if there is one DJ1l, the DJ1 gap begins at 760020 
and the next available modulo 20 boundary is 760040. All additional 
DHlls are assigned addresses modulo 20 immediately after the first 
DH11. The DH11 gap begins on the modulo 20 boundary following the 
last DH11. 


After all DH11 addresses and the DH11 gap are defined, DQl11, DU11, 
DUP11, LK11, DMC11l, DZ11, and KMCll addresses and the required gaps 
can be assigned in sequence. Addresses for any future floating 
address devices will be assigned in a similar manner. 


E.3 FLOATING ADDRESS WORKSHEET 


The algorithm for assignment of floating addresses can be confusing 
for a large configuration with multiple units of several types of 
floating address devices. The floating address worksheet that follows 
is a graphic aid that should eliminate some confusion and relieve 
configuration problems. The worksheet allows you to assign device 
addresses quickly without referring to the formal rules. Instructions 
for use of the worksheet follow. Two configuration examples (Example 
E-l and Example E~2) and a blank worksheet (Example E-3) at the end of 
this appendix are provided for general use. 


ADDRESS AND VECTOR ASSIGNMENTS 


E.3.1 Worksheet Format 


The worksheet is divided into four sections covering the address range 


760010 


through 762000. Although the floating address area continues 


up to address 764000, the worksheet should cover most configurations. 
If necessary, you can create a second worksheet by adding 2000 to all 
addresses listed. 


E.3.2 Worksheet Instructions 


The following are the instructions for the use of the worksheet: 


1. 


2. 


Record the quantity of each type of floating address device 
in the space provided on the worksheet. 


Beginning at the upper left of the worksheet at address 
760010 and proceeding down the DJ11 column, record the unit 
numbers for all DJlls in the configuration. Begin with unit 
0 and end with unit n-l. (There are n DJl1ls_ in the 
configuration.) 


Immediately below the last DJ1l unit, mark an xX for the 
required DJ1ll address gap. Also mark an xX _ in the box 
immediately to the right (DH11 column). 


In general, when numbering device units down the appropriate 
column, use only the unshaded boxes. The shaded boxes 
represent illegal addresses for the particular device type. 
Because the gap address must also be a legal device address, 
use only an unshaded box for the gap X when numbering down a 
column. 


In marking an X in the column to the right of a device 
address gap, use shaded boxes because the X in the next 
column merely provides a starting point for numbering units 
of the next device type. If there are no units of a 
particular device type, enter only the gap Xs on the 
worksheet. 


If you use all available space in one section of the 
worksheet, simply copy the entries on the last line of the 
full section to the top line of the next section. Then 
continue numbering in the new section. 


Continuing just below the X in the DH11 column, number all 
DH11 units. Once again, start with unit 0 and continue to 
unit n-l. Skip the shaded boxes in numbering down the 
column. In the first unshaded box below the last DH11 unit, 
mark an X for the DH1l gap. Also mark an X in the box to the 
right, whether it is shaded or unshaded. 


Continue with the remaining floating address devices. In 
each case, number units from 0 to n-1 down the column 
beginning in the first unshaded box below the X. Mark an xX 
in the next unshaded box below the last unit and in the box 
immediately to the right of the last unit (whether that box 
is shaded or unshaded). 


After you have recorded all floating address devices, you can 
read the UNIBUS address for each device unit directly from 
the worksheet. 
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FLOATING ADDRESS WORKSHEET 


DEVICE 


(EXAMPLE 1) 


DEVICE 


DEVICE 


761010 


761410 


761020 


761030 


761040 


761050 


760500 


760510 


760570 


Eagee 


reo | a TT TT 
eet ttt 


761060 


761420 


761070 


761430 


761440 


761470 


761100 


761500 


761110 


761510 


a 


pe 


DMC11 
0211 
KMC11 


QTY {n) 


3 
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761130 
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761160 
761170 


aie | 
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ADDRESS 
7G00l Oo 
160020 
70070 
760/20 


740/50 


761370 
761400 


-+tg 


UNIT ADDRESS 
/ 760!160 


a 760!170 
Q 760a/0 


761520 


761530 


761570 
761600 


--o20 


ADDRESS 


ZK-357-81 
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DEVICE 


--o02Z20 


(EXAMPLE 2) 


DEVICE 


761010 


761020 


761030 


761040 


761050 


761060 


761070 


761100 


761110 


761120 


761130 


761400 


DEVICE 


=-Nog 


= 


761410 


761420 


761430 


761440 


761450 


761460 


761470 


761500 


761510 


761520 


761530 


761670 


761700 


761710 


761720 


761330 


761340 


761360 


761730 


761740 


763750 


761760 


a 
gauge 


761370 


ADDRESS 
760020 
760040 
ZeQ0bo 
ZEO1lO 
7@ 0120 


7 


(40 


761400 


|| | BIR 


761770 


762000 


DEV 


ADDRESS 


ZK-358-81 
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DEVICE 
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760260 


760270 
760300 
760310 
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2 sar 


(EXAMPLE 3) 


DEVICE 


761070 


DEVICE 


761110 


760320 


761120 


760330 
760340 


760350 


760360 


761130 


761140 


761330 


761570 
761600 


761720 


761670 | . 
761700 
761710 


761730 | 


761340 


761740 
zs 


761350 


760370 


QTY (n) 
DJ11 0 ee DMC11 
DH11 DZ11 
dati KMC11 
DU11 
DUP11 
LK11 


QTY (n) 


761360 


761750 


761370 


ADDRESS 


761400 


ADDRESS 


ZK-359-81 
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This appendix lists the user file directories (UFDs) that make up 
The directories are listed 


RSX-11M Version 


distribution 


kit. 


APPENDIX F 


DIRECTORY LISTINGS 


4.2 distribution 
under the label of the volume they are located on in 


Therefore, 


of directories or files. 


kits. 


F.1 DISK DISTRIBUTION KIT VOLUME CONTENTS 


if your disk distribution kit is one 
other than an RLO1, you can use Table F-1 as a guide to 


Table 1 lists the number of disks, the volume labels, and the volume 
contents of each type of disk distribution kit. You can then refer to 
the list of directories under the appropriate volume labels to find 


the locations of specific directories and files in your type of kit. 


Table F-1l 
Volume Contents 


Disk Number of Volume RLO1 Volume 
Type Disks Label (s) Contents 
RLO1 7 RS XM38 RSXM38 
EXCPRV EXCPRV 
PRVBLD PRVBLD 
RLUTIL RLUTIL 
MCRSRC MCRSRC 
HLPDCL HLPDCL 
RMSV20 RMSV20 
RLO2 5 RSXM38 RS XM38 
EXCPRV EXCPRV 
PRVBLD PRVBLD, RLUTIL 
MCRSRC MCRSRC, HLPDCL 
RMSV20 RMSV20 
RKO06 2 RSXM38 RSXM38, EXCPRV, PRVBLD, RLUTIL 
CLISRC MCRSRC, HLPDCL, RMSV20 
All other disks 1 RS XM38 All volumes 


RSXM38 


F.1.1 RSXM38 


EXEMC.MLB;1 
EXELIB.OLB;1 


KITIDENT.DAT;1 
ODT.OBJ;1 


TRACE .OBJ;1 
VMLIB.OLB;1 
RS XMAC.SML;1 
DEUNA.MLB;1 
UNAMC.TSK;1 
LUAMC.TSK;1 
SYSLIB.OLB;1 
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UFD [1,1] 


Total of 698./705. blocks in 1l. files 


STARTUP.CMD;1 


RMS INSTAL.CMD;1 


QIOSYM.MSG;1 


UFD [1,2] 


Total of 49./49. blocks in 3. files 


Total 


Total 


Total 


Total 


Total 


Total 


of 


of 


of 


of 


of 


of 


0./0. 


0./0. 


0./0. 


0./0. 


0./0. 


0./0. 


UFD [1,3] 


blocks in 0. 


UFD [1,4] 


blocks in 0. 


UFD [1,6] 


blocks in 0. 


UFD [1,7] 


blocks in 0. 


UFD [1,20] 


blocks in 0. 


UFD [1,24] 


blocks in 0. 


files 


files 


files 


files 


files 


files 


Total of 0./0. 


Total of 0./0. 
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RSXM38 (Cont.) 


UFD [1,30] 


blocks in 0. files 


UFD [1,34] 


blocks in 0. files 


UFD [1,50] | 


Total of 0./0. blocks in 0. files 


ACS.TSK;1 
DMO.TSK;1 


FCPSML.TSK;1 


ICP.TSK;1 

INS.TSK;1 

LOA.TSK;1 

MCR.TSK;1 

MOU.TSK;1 

RCT.TSK;1 

SAV.TSK;1 

TKN. TSK; 1 

UNL. TSK;1 

DBDRV. TSK; 1 
DBDRV.STB;1 
DDDRV.TSK31 
DDDRV.STB;1 
DKDRV.TSK;1 
DKDRV.STB;1 
DLDRV.TSK;1 
DLDRV.STB;1 
DMDRV. TSK; 1 
DMDRV.STB;1 
DPDRV.TSK31 
DPDRV.STB;1 
DRDRV. TSK; 1 
DRDRV.STB;1 
DUDRV.TSK;1 
DUDRV.STB;1 
DXDRV.TSK}1 
DXDRV.STB;1 
DYDRV.TSK;1 
DYDRV.STB;1 
PUCOM.TSK;1 
PUCOM.STB;1 
LPDRV.TSK;1 
LPDRV.STB;1 
MMDRV. TSK; 1 
MMDRV.STB;1 
MSDRV.TSK;1 
MSDRV.STB;1 
MTDRV.TSK;1 
MTDRV.STB;1 


UFD [1,54] 
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RSXM38 (Cont.) 


MUDRV. TSK; 1 
MUDRV.STB;1 
RSX11M.SYS;1 
RSX11M.STB;1 
BRU. TSK;1 
SGNPARM.CMD;1 
ACF. .BSL;1 
BOO.TSK;1 
INI.TSK;1 
UFD.TSK;1 
RSX11M.TSK;1 
BASVMR.CMD;1 
ACO.TSK;1 
VMR.TSK;1 
MFT .TSK;1 
EDI.TSK;1 
FLX.TSK;1 
LBR.TSK;1 
MAC.TSK;1 
PIP.TSK;1 
SLP.TSK;1 
TKB.TSK;1 


DIRECTORY LISTINGS 


8. 
114. 
l. 
40. 
165. 
147. 
61. 
132. 
72. 
89. 
73. 
48. 
182. 


Total of 2463./2463. blocks 


Total of 


Total of 


Total of 


Total of 


Total of 


Total of 


0./0. 


0./0. 


0./0. 


0./0. 


0./0. 


0./0. 


UFD [1,60] 


blocks in 0. 


UFD [1,64] 


blocks in 0. 


UFD [11,20] 


blocks in 0. 


UFD [11,24] 


blocks in 0. 


UFD [11,30] 
blocks in 0. 
UFD [11,34] 


blocks in 0. 


files 


in 64. 


files 


files 


files 


files 


files 


files 


DIRECTORY LISTINGS 


RSXM38 (Cont.) 


UFD [200,200] 


TAPEKIT.CMD;1 16. 
SGNTYP.CMD;1 T 

BLDLAINIT.CMD;1 15. 
SGNSTAND.CMD;1 4, 

SGNBLDDRV.CMD;1 22. 
SYSGEN.CMD;1 74. 
SYSGEN2.CMD;1 85. 
UPDATE.CMD;1 15. 
SGNKLAB.CMD;1 70. 
SYSGEN3.CMD;1 44, 


Total of 346./346. blocks in 10. files 


UFD [1,11] 


Total of 0./0. blocks in 0. files 


UFD [11,10] 


ICDRV.MAC;1 179. 
ISDRV.MAC;1 32. 
TTDRV.MAC;1 262. 
TTATT.MAC;1 hay gE 
TTCAN.MAC;1 34. 
TTCIS.MAC;1 19. 
TTDAT.MAC;1 104. 
TTFP.MAC;1 37% 
TTICH.MAC;1 206. 
TTINI.MAC;1 78. 
TTJZ.MAC;1 8. 
TTMAC.MAC;1 30. 
TTMIS.MAC;1 7. 
TTMOD.MAC;1 28. 
TTODN.MAC;1 19. 
TTOIS.MAC;1 16. 
TTRW.MAC;1 ia hy 
TTSUB.MAC;1 75. 
TTTBL.MAC;1 23. 
TTYH.MAC;1 43. 
TTYHV.MAC;1 49, 
TTYJ.MAC;1 6. 
TTYL.MAC;1 14. 
TTYZ.MAC;1 19. 


Total of 1576./1576. blocks in 24. files 


UFD [12,20] 


Total of 0./0. blocks in 0. files 


UFD [12,24] 
Total of 0./0. blocks in 0. files 
Grand total of 5132./5139. blocks in 112. files in 23. 


Girectories 
F-5 


DIRECTORY LISTINGS 


EXCPRV 


F.1.2 EXCPRV 


UFD [1,30] 


Total of 0./0. blocks in 0. files 


UFD [1,34] 
Total of 0./0. blocks in 0. files 


UFD [11,10] 


RSXMCO.MAC;1 8. 
BFCTL.MAC;1 18. 
CORAL.MAC;1 29. 
CRASH.MAC ;1 118. 
CVRTM.MAC;1 5. 
DRABO.MAC;1 4, 
DRASG.MAC;1 10. 
DRATP.MAC;1 12. 
DRATX.MAC;1 9. 
DRCIN.MAC;1 ois 
DRCLI.MAC;1 33% 
DRCMT ..MAC;1 Ts 
DRDAR.MAC;1 6. 
DRDCP.MAC;1 S. 
DRDSP.MAC;1 46. 
DREIF.MAC;1 42. 
DREXP.MAC;1 16. 
DRGCL.MAC;1 36. 
DRGEF.MAC;1 19. 
DRGIN.MAC;1 Tg 
DRGLI.MAC;1 6. 
DRGPP.MAC;1 ll. 
DRGSS.MAC;1 3. 
DRGTK.MAC;1 12. 
DRGTP.MAC;1 16. 
DRMAP.MAC;1 58. 
DRMKT.MAC;1 Ti 
DRSMG.MAC;1 13. 
DRSWS.MAC;1 Ts 
DRPUT.MAC;1 22. 
DRQIO.MAC;1 75. 
DRRAS.MAC;1 15. 
DRREG.MAC;1 37. 
DRREQ.MAC;1 5. 
DRRES .MAC;1 12. 
DRSED.MAC;1 26. 
DRSPW.MAC;1 86. 
DRSST.MAC;1 9. 
DRSUB.MAC;1 38. 
ERROR.MAC;1 39. 
ERSUB.MAC;1 40. 
EXDBT.MAC;1 87. 
EXESB.MAC;1 28 


INITL.MAC;1 
IOSUB.MAC;1 
LOADR.MAC;1 
LOWCR.MAC;1 
MDSUB.MAC;1 
MEMAP.MAC;1 
PANIC.MAC;1 
' PARTY.MAC;1 
PLSUB.MAC;1 
POWER.MAC;1 
PMT .MAC;1 
QUEUE.MAC;1 
REQSB.MAC;1 
SSTSR.MAC;1 
SYSCM.MAC;1 
SYSDF.MAC;1 
SYSXT.MAC;1 
SYTAB.MAC;1 
TDSCH.MAC;1 
ADDRV.MAC;1 
AFDRV.MAC;1 
ARDRV.MAC ;1 
CTDRV.MAC;1 
DDDRV.MAC;1 
DBDRV.MAC;1 
DFDRV.MAC;1 
DKDRV.MAC;1 
DLDRV.MAC;1 
DMDRV.MAC;1 
DPDRV.MAC 31 
DRDRV.MAC;1 
DSDRV.MAC ;1 
DSSDI.MAC;1 
DTDRV.MAC ;1 
DU.MAC;1 
MU.MAC ;1 


DSAPRE.MAC;1 
MSCPDRV.MAC ;1 


PUCOM.MAC;1 
DXDRV.MAC ;1 
DYDRV.MAC;1 
DYCOM.MAC;1 
EMDRV.MAC;1 
GRDRV.MAC ;1 
ICOM.MAC; 1 
ISCOM.MAC;1 
LKDRV.MAC;1 
LSDRV.MAC;1 
MFDRV.MAC;1 
MMDRV.MAC;1 
MSDRV.MAC;1 
MTDRV.MAC;1 
NLDRV.MAC;1 
NTDRV.MAC;1 
PPDRV.MAC;1 
PRDRV.MAC;1 
UDCOM.MAC;1 
UDDRV.MAC;1 


DIRECTORY LISTINGS 


EXCPRV (Cont.) 


DIRECTORY LISTINGS 


EXCPRV (Cont.) 


XBDRV. MAC; 1 28. 
XLDRV.MAC ;1 28. 
XPDRV.MAC;1 25. 
XQDRV.MAC 31 4l. 
XUDRV.MAC;1 27. 
XWDRV.MAC;1 27. 
CODRV.MAC;1 10. 
CRDRV.MAC ;1 37. 
LADRV.MAC;1 93. 
LPDRV.MAC ;1 23. 
XEDRV.MAC;1 421. 
XEPRE.MAC;1 1. 

XMDRV.MAC;1 66. 


Total of 4328./4328. blocks in 114. files 


UFD [11,20] 


Total of 0./0. blocks in 0. files 


UFD [11,24] 


Total of 0./0. blocks in 0. files 


UFD [12,10] 


DV20V.MAC;1 51. 
SPSOV.MAC;1 71. 
STSUB.MAC;1 16. 
SX10V.MAC ;1 42. 
SX20V.MAC;1 52. 
SX30V.MAC ;1 18. 
SX40V.MAC;1 52.- 
ST50V.MAC ;1 49. 


Total of 351./35l. blocks in 8. files 


UFD [12,20] 


Total of 0./0. blocks in 0. files 


UFD [12,24] 


Total of 0./0. blocks in 0. files 


SGNEXEC.CMD;1 
SGNICIS.CMD;1 
SGNPER.CMD;1 
SGNTT.CMD;1 


UFD [200,200] 


186. 
46. 
189, 
44. 


Total of 465./465. blocks in 4. files 


Grand total of 5144./5144. blocks in 126. 


F-8 


files in 9. directories 


DIRECTORY LISTINGS 


F.1.3 PRVBLD 


UFD [1,1] 
KMCLP.BIN;1 6. 
FCSMTA.OBJ;1 30. 
LPA.OBJ;1 16. 
LPS.OBJ;1 5. 
PURICR.OBJ;1 6. 
PURISA.OBJ;1 8. 
PURPCS.OBJ;1 14, 
PURUDC.OBJ;1 3. 


Total of 88./88. blocks in 8. files 


UFD [1,20] 
ACSBLD.BLD;1 2. 
BOOBLD.BLD;1 5. 
BYEBLD.BLD;1 3. 
HELBLD.BLD;1 8. 
INSBLD.BLD;1 3. 
LOABLD.BLD;1 4. 
LPIBLD.BLD;1 2. 
MCRBLD.BLD;1 18. 
MCMBLD.BLD;1 10. 
PMDBLD.BLD;1 ll. 
SAVBLD.BLD;1 14. 
SHFBLD.BLD;1 2. 
SHUBLD.BLD;1 2. 
TKNBLD.BLD;1 2. 
UNLBLD.BLD;1 2. 
UMLBLD.BLD;1 2. 
ACNBLD.BLD; 1 4. 
BROBLD.BLD;1 2. 
COTBLD.BLD;1 5. 
DCLBLD.BLD;1 21. 
DMOBLD.BLD;1 3. 
ELIBLD.BLD;1 4. 
ERLBLD.BLD; 1 5. 
FCPMINBLD.BLD;1 18. 
FCPSMLBLD.BLD;1 12. 
FCPMDLBLD.BLD;1 18. 
FCPLRGBLD.BLD;1 10. 
FCSRS1BLD.BLD;1 12. 
F11MSGBLD.BLD;1 3. 
ICPBLD.BLD;1 8. 
ICQBLD.BLD;1 9. 
ICPCOMBLD.BLD;1 22. 
LPPBLD.BLD;1 21. 
INIBLD.BLD;1 7. 
MOUBLD.BLD;1 4. 
MTABLD.BLD;1 18. 
PMTBLD.BLD;1 8. 
PRTBLD.BLD;1 10. 
QMGBLD.BLD;1 17. 


PRVBLD 


DIRECTORY LISTINGS 


PRVBLD (Cont.) 


QCLBLD.BLD;1 9. 
QPRBLD.BLD;1 2s 
RCTBLD.BLD;1 2. 
RMDBLD.BLD;1 LS 
TDXBLD.BLD;1 Zs 
UFDBLD.BLD;1 2% 
ICBLD.CMD;1 1. 
ISBLD.CMD;1 Ls 
UDCBLD.CMD;1 Ls 
LPINIT.OBJ;1 4. 
SYSROT.OBJ;1 Ls 
BOO.OLB;1 bis 
ERL.OLB;1 35. 
FCP.OLB;1 88. 
FIL.OLB;1 124. 
F1IMSG.OLB;1 9. 
ICP11M.OLB;1 126. 
ICQ1LIM.OLB;1 129. 
INI.OLB;1 84. 
INS .OLB;1 35: 
LOA.OLB;1 43. 
MCR.OLB;1 195. 
MLTUSR.OLB;1 81. 
MTA.OLB;1 102. 
PMD.OLB;1 5.1 
RMD.OLB;1 71. 
SAV.OLB;1 66. 
DCLO.OLB;1 733: 
DCLR.OLB;1 54. 
LAINIT.OLB;1 21. 
PRT.OLB;1 19. 


Total of 2434./2436. blocks in 70. files 


UFD [1,24] 
ICBLD.CMD;1 i. 
ISBLD.CMD;1 l. 
UDCBLD.CMD;1 A ie 
LPINIT.OBJ;1 4. 
SHUFL.OBJ;1 4. 
SYSROT.OBJ;1 i. 
TDX.OBJ;1 12. 
BOO.OLB;1 Lis 
COT.OLB;1 26. 
ERL.OLB;1 35. 
FCP.OLB;1 92. 
FIL.OLB;1 124. 
ICP11M.OLB;1 L27. 
ICQ11M.OLB;1 alec 
INI.OLB;1 84. 
INS.OLB;1 37. 
LOA.OLB;1 47. 
LPP.OLB;1 60. 
MCR.OLB; 1 230. 
MLTUSR.OLB;1 81. 
MTA.OLB;1 103. 
PMD.OLB;1 33. 


DIRECTORY LISTINGS 


PRVBLD (Cont.) 


QMG.OLB;1 TD 
QMGCLI.OLB;1 90. 
RCT.OLB;1 18. 
RMD.OLB;1 99. 
SAV.OLB;1 69. 
UML.OLB;1 6. 

LAINIT.OLB;1 21. 
PIPUTL.OLB;1 26. 


Total of 1651./1654. blocks in 30. files 


UFD [1,30] 


Total of 0./0. blocks in 0. files 


UFD [1,34] 


Total of 0./0. blocks in 0. files 


UFD [11,20] 


Total of 0./0. blocks in 0. files 


UFD [11,24] 


Total of 0./0. blocks in 0. files 


UFD [12,20] 


Total of 0./0. blocks in 0. files 


UFD [12,24] 
Total of 0./0. blocks in 0. files 


Grand total of 4173./4178. blocks in 108. files in 9. directories 


DIRECTORY LISTINGS 


RLUTIL 


F.1.4 RLUTIL 


UFD [1,20] 
ACOBLD.BLD;1 S% 
ACFBLD.BLD;1 26 
BADBLD.BLD;1 2. 
BRUBLD.BLD;1 8. 
CDABLD.BLD;1 21. 
CFLBLD.BLD;1 10. 
CMPBLD.BLD;1 6. 
CRFBLD.BLD;1 ll. 
DSCBLD.BLD;1 Vs 
DMPBLD.BLD;1 9. 
EDIBLD.BLD;1 8. 
EDTBLD.BLD;1 47. 
FLXBLD.BLD;1 18. 
FMTBLD.BLD;1 4. 
FTBBLD.BLD;1 5s 
IOXBLD.BLD;1 22. 
LBRBLD.BLD;1 24. 
MACBLD.BLD;1 18. 
PATBLD.BLD;1 8. 
PIPBLD.BLD;1 25. 
RPTBLD.BLD;1 16. 
SLPBLD.BLD;1 7. 
STKBLD.BLD;1 9. 
MAKESTK.CMD;1 4. 
TKBBLD.BLD;1 9. 
TKBCOMBLD.BLD;1 24. 
VF YBLD.BLD;1 9. 
VMRBLD.BLD;1 3% 
ZAPBLD.BLD;1 4. 
CDA.OLB;1 159. 
VMR.OLB;1 2375 
BAD.OLB;1 36. 
BRU.OLB;1 287. 
CMP.OLB;1 26. 
CRE .OLB;1 40. 
DSC .OLB;1 164. 
DMP.OLB;1 39. 
EDI.OLB;1 57 
EDTLIB.OLB;1 376. 
FLX.OLB;1 143. 
FMT.OLB;1 55, 
FTB.OLB3;1 Liz. 
IOX.OLB;1 128. 
LBR.OLB;1 70. 
MAC.OLB;1 150. 
NEISLB.OLB;1 14, 
PAT.OLB;1 34. 
PIP.OLB;1 96. 
PIPUTL.OLB;1 26. 
RPT.OLB;1 220. 
SLP.OLB;1 * 34. 
TKB.OLB;1 314. 
UML.OLB;1 6. 
VF Y.OLB;1 53. 
ZAP.OLB;1 33. 


Total of 3262./3312. blocks in 55. files 


F-12 


DIRECTORY LISTINGS 


RLUTIL (Cont.) 


UFD [1,24] 
ACF .OLB;1 36. 


Total of 36./36. blocks in l. file 


UFD [1,30] 
Total of 0./0. blocks in 0. files 


UFD [1,34] 


Total of 0./0. blocks in 0. files 


UFD [1,50] 


Total of 0./0. blocks in 0. files 


UFD [1,51] 
BRU64K.SYS;1 258. 
BRU64K.STB;1 13. 
BRUSYS.SYS;1 434. 
BRUSYS.STB;1 13. 


Total of 718./718. blocks in 4. files 


UFD [1,54] 
Total of 0./0. blocks in 0. files 


Grand total of 4016./4066. blocks in 60. files in 7. directories 


DIRECTORY LISTINGS 


? 


MCRSRC 


F.1.5 MCRSRC 


UFD [1,1] 
EXEMC.MLB;1 73. 
RSXMAC.SML;1 287. 


Total of 360./360. blocks in 2. files 


UFD [1,2] 


Total of 0./0. blocks in 0. files 


UFD [11,10] 


Total of 0./0. blocks in 0. files 


UFD [12,10] 


BYE.MAC;1 47. 
BRKOV.MAC;1 3. 
CBTO.MAC;1 7. 
CDT2B.MAC;1 6. 
COT2B.MAC;1 4. 
DFSYM.MAC;1 19. 
EDCKP.MAC;1 4. 
FMTDV.MAC;1 4. 
GNBLK.MAC;1 5. 
GTBYT.MAC;1 6. 
GTMNM.MAC;1 4. 
GTTSK.MAC;1 8. 
ICBDEF.MAC;1 5. 
ABOOV.MAC;1 24. 
BOOT.MAC;1 29. 
BOTPH2.MAC;1 19. 
ALLSUB.MAC;1 21. 
FLAOV.MAC;1 19. 
SAVSUB.MAC;1 356 
MCRDIS.MAC;1 80. 
INSFSR.MAC;1 2. 
INSGC.MAC;1 2. 
KEYWD.MAC;1 5. 
LDBUF.MAC;1 6. 
LDCTL.MAC;1 31. 
LDDRV.MAC ;1 26. 
LDFIL.MAC;1 8. 
LDUIC.MAC;1 3. 
LKLST.MAC;1 7. 
CLQOV.MAC;1 19. 
RAPOV.MAC;1 14. 
REAOV.MAC;1 7. 
MCROV.MAC;1 60. 
ST1OV.MAC;1 36. 


TISUBS.MAC;1 
UNLFIL.MAC;1 
MDPOV.MAC ;1 
INSLB.MAC;1 
SAVSIZ.MAC;1 
INSFL.MAC;1 
TKTN.MAC;1 
IODAT.MAC;1 
FILBN.MAC;1 
ALLOV.MAC;1 
DEVOV.MAC;1 
SX40V.MAC;1 
SX20V.MAC;1 
SAVCPU.MAC;1 
MCRDEF.MAC;1 
PR1OV.MAC;1 
SPSOV.MAC;1 
ST20V.MAC;1 
SAVEN .MAC;1 
WRTMS ..MAC;1 
SYSROT.MAC;1 
SAVST.MAC;1 
SAVTRC.MAC;1 
SAVBOT.MAC;1 
SAVC1.MAC;1 
SAVDB.MAC;1 
SAVDF.MAC;1 
SAVDK.MAC;1 
SAVDL.MAC;1 
SAVDM.MAC;1 
SAVDP.MAC;1 
SAVDR.MAC;1 
SAVDS.MAC;1 
SAVDT.MAC;1 
SAVDX.MAC;1 
SAVDRT.MAC;1 
SAVDY.MAC;1 
LDFIN.MAC;1 
TIMOV.MAC;1 
MCROOT.MAC;1 
LUNOV.MAC 31 
SYMTB.MAC;1 
OPEOV.MAC;1 
SSMOV.MAC;1 
SAVEM.MAC 31 
FNDUCB.MAC;1 
SX10V.MAC;1 
INSBF.MAC;1 
ACTFIL.MAC;1 
ST30V.MAC;1 
SRTOV.MAC;1 
ERMSG.MAC;1 
SX30V.MAC;1 
GETNUM.MAC;1 
INSCM.MAC;1 
STSUB.MAC;1 
ASNOV.MAC;1 
CLIOV.MAC;1 
SAVDU.MAC;1 


DIRECTORY LISTINGS 


MCRSRC (Cont.) 


DIRECTORY LISTINGS 


MCRSRC (Cont.) 


BOOTRC.MAC;1 2. 
LDLDB.MAC;1 22. 
COLOG.MAC;1 9. 
SAVC2.MAC;1 17% 
SAVC3.MAC;1 6. 
MGCML.MAC;1 35. 
NETSUB.MAC;1 2. 
REQCOT.MAC;1 1l. 
ACS .MAC;1 23. 
ALTOV.MAC;1 15. 
DEAOV.MAC;1 9. 
ATLOV.MAC;1 49. 
FIXOV.MAC;1 a1 
INSROT.MAC;1 18. 
SYSOV.MAC;1 23. 
REDOV.MAC;1 13. 
PAROV.MAC;1 24. 
TASOV.MAC;1 37. 
SAVE.MAC;1 62. 
ST40V.MAC;1 29. 
INSPS.MAC;1 26. 
INSHD.MAC;1 28. 
UNLCTL.MAC;1 30. 
ERRMSG. MAC;1 Li, 
ERROV.MAC;1 15. 
RPSOV.MAC;1 30. 
RUNOV.MAC;1 26. 
DV20V.MAC;1 51. 
SAVINS.MAC;1 68. 
ST50V.MAC;1 49, 
ICPASK.MAC;1 6. 
ICPASV.MAC;1 14. 
ICPAS1.MAC;1 12. 
ICPAS4.MAC;1 9. 
ICPCHA.MAC;1 qs 
ICPCHN.MAC;1 9. 
ICPERA.MAC;1 5. 
ICPFDC.MAC;1 12. 
ICPFEX.MAC;1 4. 
ICPFIL.MAC;1 2 
ICPFMI.MAC;1 2. 
ICPFMO.MAC;1 2. 
ICPFMS.MAC;1 27 
ICPFMX.MAC;1 4. 
ICPFUT.MAC;1 22. 
ICPF10.MAC;1 2; 
ICPF52.MAC;1 1. 
ICPGNB.MAC;1 6. 
ICPGOT.MAC;1 16. 
ICPIF1.MAC;1 9. 
ICPIF2.MAC;1 6. 
ICPIF4.MAC;1 9. 
ICPMEM.MAC;1 5. 
ICPMEN.MAC;1 a5 
ICPNEC.MAC;1 1. 
ICPNEI.MAC;1 a 
ICPNEN.MAC;1 2. 
ICPNET.MAC;1 14. 
ICPNEX.MAC;1 3. 


ICPNPR.MAC;1 
ICPNP1.MAC;1 
ICPPRS.MAC;1 
ICPSTP.MAC;1 
ICPSUT.MAC;1 
ICPSU1.MAC;1 
ICPSU5.MAC;1 
ICPSY2.MAC;1 
ICPSY3.MAC;1 
ICPTES.MAC;1 
ICPTPA.MAC;1 
INIALL.MAC;1 
INIBIT.MAC;1 
INIHOM.MAC;1 
ININDX.MAC;1 
INIMAG.MAC;1 
INIUPD.MAC;1 
INIPAR.MAC;1 
UFD.MAC;1 
UFDPAR.MAC;1 
UFDPTB.MAC;1 
UFDTP.MAC;1 
ICPVEC.MAC;1 
ICPPOP.MAC;1 
ICPIN5.MAC;1 
ICPENB.MAC;1 
ICPSU2.MAC;1 
ICPIF3.MAC;1 
ICPWFT.MAC;1 
ICPXMD.MAC;1 
ICPAS2.MAC;1 
ICPAS3.MAC;1 
ICPSU3.MAC;1 
ICPGTN.MAC};1 
ICPIN4.MAC;1 
MOUCLS.MAC;1 
MOUPRE.MAC;1 
CRETSK.MAC;1 
MSGOUT.MAC;1 
TPNUMB .MAC31 
TPARS2.MAC;1 
TPDEB.MAC;1 
TPMAC2.MAC;1 
MOUDIS.MAC;1 
SMLGCL.MAC;1 
ICPAS5.MAC;1 
MOUMSG.MAC;1 
MOUDAT .MAC;1 
ICPSU4.MAC;1 
ICPONR.MAC;1 
ICPERR.MAC;1 
ICPATS.MAC;1 
ICPPAR.MAC;1 
DISMNT.MAC;1 
ICPEXF.MAC;1 
ICPIN3.MAC;1 
ICPMCR.MAC;1 
ICPPO1.MAC;1 


DIRECTORY LISTINGS 


MCRSRC (Cont.) 


DIRECTORY LISTINGS 


MCRSRC (Cont.) 


ICPSYT.MAC;1 27. 
ICPSY1.MAC;1 273 
ICPTDV.MAC;1 18. 
ICPSUB.MAC 31 28. 
ICPBLK.MAC;1 8. 
ICPPRC.MAC;1 13. 
INIBAD.MAC;1 55. 
ICPPRE.MAC;1 31. 
MOUFOR.MAC;1 31. 
MOUPAR.MAC;1 43. 
MOUSUB .MAC;1 53. 
MOUTAP.MAC;1 39. 
ICPGTK.MAC;1 13. 
ICPINX.MAC;1 6. 
ICPSET.MAC;1 qe 
ICPPDW.MAC ;1 15. 
ICPEXI.MAC;1 12. 
ICPSYC.MAC;1 16. 
ICPIMP.MAC;1 33. 
ICPFCL .MAC ;1 8. 
VMSPAR.MAC;1 1. 
INIGCL.MAC;1 70. 
ICPIN2.MAC;1 9. 
ICPFOP.MAC;1 21; 
MOUDSK.MAC;1 26. 
MOUROT.MAC;1 9. 
ICPROT.MAC;1 33. 
ICPSU6.MAC;1 5. 
HELLO. MAC; 1 130. 
INIROT.MAC;1 58. 
XEPRE.MAC;1 1. 
INDSYS.CLB;1 106. 


Total of 4874./4968. blocks in 242. files 


UFD [12,20] 


LOAASM.CMD;1 2. 
MCRASM.CMD;1 14. 
MCRLIBBLD.CMD;1 3. 
FILASM.CMD;1 4. 
FILLIBBLD.CMD;1 l. 
ICPASM.CMD;1 12: 
ICPLIBBLD.CMD;1 2. 
INIASM.CMD;1 2. 
INILIBBLD.CMD;1 l. 


Total of 41./41. blocks in 9. files 


UFD [12,24] 


LOAASM.CMD; 1 2. 
MCRASM.CMD;1 14. 
MCRLIBBLD.CMD; 1 3. 
FILASM.CMD;1 4. 
FILLIBBLD.CMD;1 1. 


ICPASM.CMD;1 


ICPLIBBLD.CMD;1 


INIASM.CMD;1 


INILIBBLD.CMD;1 


DIRECTORY LISTINGS 


MCRSRC (Cont.) 


2. 


1 

2. 
2. 
1. 


Total of 41./41. blocks in 9. files 


UFD [12,30] 


Total of 0./0. blocks in 0. files 


UFD [12,34] 


Total of 0./0. blocks in 0. files 


GBLCHA.MAC;1 
VO5CHA.MAC;1 
V50CHA.MAC;1 
V52CHA.MAC;1 
V1LHCHA.MAC;1 
GBLGBM.MAC ;1 
GBLHLM.MAC;1 
VO5HLM.MAC;1 
V50HLM.MAC;1 
V52HLM.MAC;1 
V1HHLM. MAC;1 
L36HLM.MAC;1 
GBCMD.MAC;1 

GBPAGE.MAC;1 
HLPAGE.MAC;1 
NUL11S.MAC;1 
GBINIT.MAC;1 
GBLMDM.MAC;1 
L36CHA.MAC;1 
RMDRIV.MAC;1 
TERMID.MAC;1 
ATCMD.MAC;1 

GBLATM.MAC;1 
VO5ATM.MAC31 
GBLTHM.MAC;1 
V52ATM.MAC;1 
L36THM.MAC;1 
V50ATM.MAC;1 
THCMD.MAC;1 

V1HATM.MAC;1 
L36ATM.MAC;1 
V1HTHM.MAC;1 
V50THM.MAC;1 
V52THM.MAC 31 
HLINIT.MAC;1 
RMDMAC ..MAC 71 
GBLIOM.MAC;1 


UFD [14,10] 


3. 
3. 
2. 
2. 
3. 
Ls 
l. 
2. 
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MCRSRC (Cont.) 


DIRECTORY LISTINGS 


VO5IOM.MAC;1 5. 
V1HIOM.MAC;1 5. 
V52I10M.MAC;1 5. 
V5010M.MAC;1 5. 
IOCMD.MAC;1 6. 
GBLSSM.MAC;1 5. 
V1HSSM.MAC;1 5. 
SSCMD.MAC;1 3. 
V52SSM.MAC;1 5. 
L36SSM.MAC;1 5. 
ATPAGE.MAC;1 29. 
SSPAGE.MAC;1 34, 
THPAGE.MAC;1 57. 
IOPAGE.MAC;1 35. 
RMDEMO.MAC; 1 48. 
IOINIT.MAC;1 ll. 
REMAP.MAC;1 3. 
MDCOM.MAC ;1 6. 
MDPAGE.MAC;1 57. 
MDCMD.MAC;1 6. 
MDINIT.MAC;1 23: 
THINIT.MAC;1 13. 
SSINIT.MAC;1 6. 
ATINIT.MAC;1 Pe 
L36MDM.MAC;1 5. 
VO5MDM.MAC;1 5. 
V1HMDM.MAC;1 5. 
V50MDM.MAC ;1 5. 
V52MDM.MAC;1 5. 
THF11L.MAC;1 14. 
RMDDEF .MAC;1 6. 
SSCOM.MAC};1 De 
RMDXCM.MAC; 1 5. 
IOCOM.MAC;1 ce 
GBCOM.MAC;1 2. 
ATCOM.MAC;1 4. 
THCOM.MAC;1 6. 
HLCOM.MAC;1 1. 


Total of 597./597. blocks in 75. files 


UFD [14,20] 
RMDASM.CMD; 1 8. 


Total of 8./8. blocks in 1l. file 


UFD [14,24] 
RMDASM.CMD; 1 ll. 


Total of 11./11. blocks in 1. file 


UFD [14,30] 


Total of 0./0. blocks in 0. files 


F-20 


DIRECTORY LISTINGS 


UFD [14,34] 


Total of 0./0. blocks in 0. files 


UFD [15,10] 


SHUFL.MAC;1 36. 
SHUTUP.MAC;1 54. 
ACNT.MAC;1 159. 
BROAD.MAC;1 57. 
HELLO.MAC;1 118. 
HELROT.MAC;1 156 
HLP.MAC;1 ll. 
HSTTAB.MAC;1 25. 
HLPSUB.MAC; 1 72. 


Total of 547./547. blocks in 9. files 


UFD [15,20] 


SHUTUPASM.CMD;1 1. 
MLTASM.CMD;1 Ls 
MLTLIBBLD.CMD;1 1. 


Total of 3./3. blocks in 3. files 


UFD [15,30] 


Total of 0./0. blocks in 0. files 


UFD [15,34] 


Total of 0./0. blocks in 0. files 


UFD [15,24] 


SHUTUPASM.CMD;1 1. 
SHUFLASM.CMD;1 ts 
MLTASM.CMD;1 i 
MLTLIBBLD.CMD;1 1. 


Total of 4./4. blocks in 4. files 


Grand total of 6486./6580. blocks in 355. 
directories 


F-21 


MCRSRC (Cont.) 


files in 18. 


HLPDCL 


F.1.6 HLPDCL 


DIRECTORY LISTINGS 


UFD [1,1] 
EXEMC.MLB; 1 73. 
EXELIB.OLB;1 48. 
FCS.OBJ;1 25. 
FCSMBF.OBJ;1 33. 
RS XMAC.SML;1 287. 
SYSLIB.OLB;1 238. 


Total of 704./704. blocks in 6. files 


UFD [1,2] 
HELP.ULB;1 2925. 


Total of 2925./2925. blocks in l. file 


UFD [1,6] 
ERRLOG. ULB;1 727. 
ERRLOGETC.ULB;1 72. 


Total of 799./799. blocks in 2. files 


UFD [23,10] 


ASSIGN.MAC;1 6. 
DEALLO.MAC;1 3 
ALFN.MAC;1 10. 
ALFNUM.MAC;1 PSs 
ALL.MAC;1 5. 
LOGIN.MAC;1 3% 
AND.MAC;1 9. 
ANDA.MAC;1 4. 
REQUEST.MAC;1 23 
DEASSIGN.MAC;1 4, 
FIX.MAC;1 3% 
CALLOV.MAC;1 Ts 
CATCHALL.MAC;1 Ss 
CBM.MAC ;1 Se 
SUBMIT.MAC;1 20. 
UNFIX.MAC;1 3% 
COP.MAC;1 3. 
REMOVE.MAC;1 4. 
CONVERT.MAC;1 9. 
DQBFS.MAC;1 4. 
ELEMENT.MAC;1 226 
SORT.MAC;1 30. 
EOL.MAC;1 36 
ERR1.MAC;1 3. 
ERRORR.MAC;1 2s 
FLAGS.MAC;1 4. 
FNAM.MAC;1 ds 


DIRECTORY LISTINGS 


HLPDCL (Cont.) 


GTARG.MAC;1 5. 
JSR.MAC;1 33 
LDCCD.MAC;1 5. 
LIT.MAC;1 Lis 
LOAD.MAC;1 55 
LOVR.MAC;1 12. 
MAP.MAC;1 24. 
MATCH.MAC;1 7. 
NEW.MAC;1 4. 
NLIT.MAC;1 cP 
OR.MAC;1 6 
PARSER.MAC;1 8 
RELEASE.MAC;1 4 
HOLD.MAC;1 4. 
PRI.MAC;1 2 
PRO.MAC;1 9 
QUA.MAC;1 7 
SCTBIT.MAC;1 7. 
TRANSL.MAC;1 5, 
TST.MAC;1 5. 
UND.MAC;1 5s 
XCOPY.MAC;1 6. 
ASTOV.MAC;1 
COD.MAC;1 
CSEP.MAC;1 
CUIC.MAC;1 — 
DATE.MAC;1 
DBUG.MAC;1 
DEV.MAC;1 
EDOC.MAC 31 
FIL.MAC;1 
FSEP.MAC;1 
IFIL.MAC;1 
LAB.MAC;1 
LUIC.MAC;1 
NFT.MAC;1 
ODEV.MAC;1 
OUIC.MAC;1 
PIP.MAC;1 
PROC .MAC;1 
SEP.MAC;1 
SY.MAC;1 
T.MAC;1 
TERM.MAC;1 
TI.MAC;1 
TIME.MAC;1 
UIC.MAC;1 
VER.MAC;1 
WFIL.MAC;1 
WUIC.MAC;1 
WVER.MAC;1 2. 
WXTN.MAC;1 2's 
XTN.MAC;1 2. 
APPEND.MAC;1 ll. 
AT.MAC;1 2 
MCR.MAC;1 2 
PURGE.MAC;1 4 
5 
6 


ee @Or ee ¢ @ 
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RENAME. MAC ;1 
TYPE.MAC;1 


F-23 


DIRECTORY LISTINGS 


HLPDCL (Cont.) 


UNLOCK.MAC;1 3. 
COMMAC.MAC;1 1. 
LOGOUT.MAC;1 2 
PRINT.MAC;1 L56 
ALLOCATE.MAC;1 3% 
CONTINUE.MAC;1 3% 
NFIL.MAC;1 4. 
DCL.MAC;1 2. 
BROADCAST.MAC;1 4. 
DCLMPL.MAC;1 1. 
SPAWN.MAC;1 5s 
ERRORO.MAC;1 5. 
COPY.MAC;1 13. 
LINK1L.MAC;1 6. 
DEBUG.MAC;1 26 
PREPARSE.MAC;1 14. 
ABORT.MAC;1 4. 
DCLMAC.MAC ;1 56. 
DCLDAT.MAC;1 26. 
NOD .MAC ;1 3. 
RUN.MAC;1 13. 
MOUNT.MAC;1 19. 
LIBRARY.MAC;1 12; 
INSTALL.MAC;1 Lis 
BACKUP.MAC;1 L5% 
DIRECTORY.MAC;1 0. 
EDIT.MAC;1 12. 
LINK.MAC;1 35. 
TLINK.MAC;1 18. 
MACRO .MAC;1 19. 
DISMOUNT.MAC;1 4. 
SET1.MAC;1 36. 
HELP.MAC;1 4. 
SET.MAC;1 51 
TSET.MAC;1 53. 
STOP.MAC;1 9. 
SHOW.MAC;1 44, 
TSHOW.MAC;1 29. 
START.MAC;1 15. 
ERR.MAC;1 ll. 
XDCL.MAC;1 36. 
DSPCMD.MAC;1 39. 
FORMAT.MAC;1 10. 
COMMAND.MAC ;1 x Bel 
FORTRAN.MAC;1 19. 
COBOL.MAC;1 16. 
PASCAL.MAC;1 10. 
CORAL.MAC;1 Ss 
BASIC.MAC;1 3. 
QIOBF.MAC;1 Ts 
DIFFERENC.MAC;1 5. 
INITIAL.MAC;1 20. 
DELETE.MAC;1 13. 
DISPATCH.MAC;1 9. 
DQOBFE.MAC;1 Ty 


DIRECTORY LISTINGS 


HLPDCL (Cont.) 


CREATE.MAC;1 14. 
CANCEL.MAC ;1 2. 
DCLMIC.MAC;1 l. 
MERGE.MAC;1 20. 
ANALYZE.MAC;1 43. 


Total of 1369./1369. blocks in 146. files 


UFD [23,24] 


DCL.CMD; 1 4. 
DCLASM.CMD;1 23. 


Total of 27./27. blocks in 2. files 


UFD [23,34] 
Total of 0./0. blocks in 0. files 


UFD [24,10] 
TDX.MAC;1 85. 


Total of 85./85. blocks in 1. file 


UFD [24,24] 


TDXASM.CMD;1 l. 
CATCHALL.CMD;1 7. 


Total of 8./8. blocks in 2. files 


UFD [45,10] 


KRATE.B2S;1 Ts 
KRATE.FTN;1 7. 
KCLOKB.MAC;1 10. 
KAADMP.MAC;1 123 
KAASO3.MAC;1 5. 
KADAGR.MAC 31 6. 
KADDRV.MAC;1 14. 
KADINO.MAC;1 6. 
KADIN1.MAC;1 8. 
KADIN2.MAC;1 6. 
KADIN3.MAC;1 8. 
KADIN4.MAC;1 6. 
KADIN5.MAC;1 8. 
KADSWP.MAC;1 7. 
KAST.MAC;1 14. 
KBFRMG. MAC ;1 13. 
KCLOKA.MAC;1 5. 


DIRECTORY LISTINGS 


HLPDCL (Cont.) 


KSWDF .MAC;1 13 
KCOMM. MAC; 1 5. 
KCVADF .MAC;1 6. 
KDIGO.MAC;1 10. 
KDISWP.MAC;1 ds 
KDOSWP.MAC;1 Te 
KDSCAD.MAC;1 4, 
KDSDGO.MAC; 1 4, 
KDVDF .MAC;1 ay 
KEFQA.MAC;1 10; 
KFLT16.MAC;1 6. 
KIESTO.MAC;1 4, 
KKWDRV. MAC ;1 18. 
KLQSUB.MAC;1 7. 
KPAA.MAC;1 Ve 
KMUL.MAC;1 ce 
KRWBF .MAC;1 12. 
KRCLKB. MAC; 1 5. 
KRLOC.MAC;1 4, 
KPRE.MAC;1 4, 
KSTB.MAC;1 Te 
KSTIBF.MAC;1 5. 
KSTOP.MAC;1 5. 
LABMAC.MAC;1 6. 
KSUB.MAC;1 10. 
KGHIST.MAC;1 21. 
KSET.MAC;1 13. 
KADGCH.MAC; 1 20. 
KBFSTS.MAC;1 Ly, 
KDIO.MAC;1 12. 
KAADRV.MAC;1 24. 
KDRDRV.MAC; 1 30. 
KSTADC.MAC;1 1. 
KADINP.MAC;1 13. 


Total of 473./473. blocks in 51. files 


UFD [45,20] 


KLABMLB.CMD;1 1 
ASMK.CMD;1 1 
K4ASM.CMD;1 1 
KLIBBLD.CMD;1 l. 
KLIBRP.CMD;1 il 
KCLEAN.CMD;1 1 
KCOMBLD.CMD;1 at 


Total of 7./7. blocks in 7. files 


UFD [45,24] 


KLABMLB.CMD; 1 1 
ASMK.CMD;1 l. 
KCLEAN.CMD; 1 1 
KLIBBLD.CMD;1 1 


DIRECTORY LISTINGS 


HLPDCL (Cont.) 


KLIBRP.CMD;1 1. 
K4ASM.CMD;1 1. 
KCOMBLD.CMD; 1 1. 


Total of 7./7. blocks in 7. files 


UFD [45,30] 


Total of 0./0. blocks in 0. files 


Directory DL1: [45,34] 


Total of 0./0. blocks in 0. files 


Directory DL1: [200,200] 
FCSRES.MAC;1 12. 
Total of 12./12. blocks in 1. file 


Grand total of 6416./6416. blocks in 226. files in 14. 
directories 


DIRECTORY LISTINGS 


RMSV20 


F.1.7 RMSV20 


UFD [1,1] 
RMSLIB.OLB;1 239. 
RMSRES.STB;1 3. 
RMSRLX.ODL; 1 2. 
RMSMAC.MLB;1 189. 
RMSDAP.OLB;1 104. 
DAPRES.TSK;1 39. 
DAPRES.STB;1 2. 
DAPRLX. ODL; 1 2. 
DAP11X.ODL;1 6. 
RMS11.0DL;1 86. 
RORMS1.MAC;1 12. 
RMS11S.0DL;1 5. 
RMS11X.ODL;1 6. 
RMS12X. ODL; 1 6. 
RMS12S.0DL;1 4. 
RMSRES.TSK;1 89. 
RMSRESSUB.TSK;1 49. 


Total of 843./843. blocks in 17. files 


UFD [1,2] 
RMSDES.IDX;1 126. 


Total of 126./126. blocks in 1. file 


UFD [1,24] 
RMSRES .CMD;1 l. 
RMSRES.ODL;1 ll. 
DAPRES.CMD;1 1. 
DAPRES.ODL;1 1. 
BCKNRN.CMD;1 l. 
BCKNRN.ODL;1 5. 
BCKNON.CMD;1 is 
BCKNON.ODL;1 5. 
RSTNRN.CMD;1 1. 
RSTNRN.ODL;1 5. 
RSTNON.CMD; 1 Ls 
RSTNON.ODL;1 5. 
CNVNRN.CMD;1 l. 
CNVNRN.ODL;1 5. 
CNVNON.CMD;1 1. 
CNVNON.ODL;1 10. 
CNVNRR.CMD;1 1. 
CNVNRR.ODL;1 6. 
CNVNOO.CMD;1 1. 
CNVNOO.ODL;1 5. 
DSPNRN.CMD; 1 1. 
DSPNRN.ODL;1 3. 
DSPNON.CMD;1 l. 
DSPNON.ODL;1 3. 


F-28 


DIRECTORY LISTINGS 


RMSV20 (Cont.) 


DEFNRN.CMD; 1 1. 
DEFNRN.ODL;1 3. 
DEFNON.CMD;1 i 
DEFNON.ODL;1 3. 
DESNRN.CMD;1 l. 
DESNRN.ODL;1 é. 
DESNON.CMD;1 Ly 
DESNON.ODL;1 6. 
IFLNON.CMD;1 Lis 
IFLNON.ODL;1 5. 
IFLNRN.CMD; 1 l. 
IFLNRN.ODL;1 3. 
RMSDES.ODL;1 9. 
RMSODL.ODL;1 24. 
RMSUTL.OLB; 1 810. 


Total of 951./951. blocks in 39. files 


UFD [1,34] 
RMSRES.MAP;1 59. 
RMSRESSUB.MAP; 1 35. 
DAPRES.MAP;1 17. 


Total of 111./111. blocks in 3. files 


UFD [1,54] 
RMSCNV. TSK; 1 174. 
RMSDSP. TSK; 1 181. 
RMSDEF.TSK;1 137. 
RMSDES.TSK;1 243. 
RMSIFL.TSK;1 136. 
RMSBCK. TSK; 1 183. 
RMSRST.TSK;1 187. 


Total of 1241./1241. blocks in 7. files 


UFD [200,1] 
GSA.MAC;1 19. 
SEARCH.MAC;1 10. 
RENAME. MAC; 1 12. 
ERASE.MAC;1 10. 
PARSE.MAC;1 1l. 
SEARCH. TSK; 1 25. 
RENAME. TSK; 1 26. 
ERASE.TSK;1 25. 
PARSE.TSK;1 22. 


Total of 160./160. blocks in 9. files 


Grand total of 3432./3432. blocks in 76. files in 6. directories 


ACP 
ANSI magnetic tape, 4-29 
definition, 1-4 
Address checking, 4-28 
Ancillary Control Processor 
See ACP 
ANSLIB.OLB, 4-59 
linking tasks to, 7-4 


rebuilding user-written tasks, 


6-6 
AST, 4-31 
Asynchronous system traps 
see AST 
Autoconfigure, 1-2 
adding devices, 4-4 
description, 3-17 
failure, 3-18 
overriding results, 3-20, 4-3 
exception, 3-21 
question, 4-3 
restrictions, 3-17 
sample output, 3-19 
supported hardware, 3-21 
use, 3-17 
with saved answer files, 3-18 


Backup and Restore Utility 
see BRU 
Baseline system 
definition, 1-5 
Big-buffering support, 4-59 
BLDLAINIT.CMD, 3-5 
Bootstrap 
hardware, 1-5, B-1l 
mapped baseline system, 4-2 
procedure, B-1 
software, 1-5 
summary of addresses, B-2 
unsaved system, 6-2 
nonstandard unmapped, 6-12 
Breakpoint 
definition, 3-8 
EOS, 3-8 
EOX, 3-8 
purpose, 3-8 
BRU 
task build, 6-3 
using 
recovering disk space, 6-3 
using to backup target system 
disk, 6-9 
BRU64K, 2-5 
See also BRUSYS 
CNF, 2-5 
altering CSRs using, 2-5 
altering vectors using, 2-5 
BRUSYS, 2-4 
See also BRU64K 
CNF, 2-5 
altering CSRs using, 2-5 


INDEX 


BRUSYS 
CNF (Cont.) 
altering vectors using, 2-5 
Build files 
creating on SY:, 5-5 


Cancel Selective Marktime 
directive, 4-31 
CDA 
see Crash dump 
Chaining, 4-9 
See also Saved answer file 
See also Standard Function 
System 
definition, 3-9 
restriction, 3-9 
Checkpointing, 4-45 
with system checkpoint file, 
4-46 
CLI 
See also DCL 
user-written, 4-64 
Clock 
system, 4-16 
watchdog timer, 4-16 
Communications products 
DECnet, 4-36 
SYSGEN support, 4-36 
Configuration 
See also Autoconfigure 
saved host, 4-7 
saved peripheral, 4-8 
Control and Status Register 
see CSR 
Copy 
~RA60/80/81 tape kit 
on-line, 2-19 
RK06/07 kit 
disk kit 
on-line, 2-22 
stand-alone, 2-12 
RLO1/O2 kit 
disk kit 
on-line, 2-24 
stand-alone, 2-15 
RM02/03/05/80 tape kit 
on-line, 2-19 
RP04/05/06 tape kit 
on-line, 2-19 
tape kit 
on-line, 2-19 
stand-alone, 2-6 
target system disk 
mapped, 6-9 
unmapped, 6-19 
Crash dump 
analysis, 4-46 
CDA support, 4-46 
device, 4-47 
PANIC, 4-46 


Index-1 


INDEX 


Crash dump Device controller (Cont.) 


PANIC (Cont.) YJ, 4-90 | 
device, 4-48 YL, 4-91 
Crash Dump Analyzer YV, 4-91 
see Crash dump YZ, 4-92 
CSR DIGITAL Command Language 
altering using CNF, 2-5 see DCL, 4-63 
definition, 1-4 Directives 
floating, E-4 Cancel Selective Marktime, 4-31 
Get Mapping Context, 4-28 
DBMS-11, 4-25 memory management (PLAS), 4-27 
DCL, 4-63 Send/Receive By Reference, 4-28 
DECnet system, 4-38 
see Communications products Disk 
Default response space recovery, 6-3, 6-14 
examples, 3-6 swapping interval 
Device priority, 4-43 
example, 4-67 Swapping interval, 4-42 
logical, 4-33 write-checking support, 4-34 
pseudo, C-3 Distribution kit 
specifying, 4-18 definition, 2-1 
specifying parameters, 4-67 external volume label, 2-2 
support on RSX-11M, 4-18 guidelines for copying, 2-4 
supported on RSX-11M, C-l inventory, 2-2 
Device controller . restriction, 2-2 
AD, 4-69 types, 2-1 
AF, 4-69 Driver 
AR, 4-69 definition, 1-4 
CR, 4-70 Loadable 
CT, 4-70 partition for, 5-11 
DB, 4-71 loadable, 4-30 
DD, 4-72 default to, 4-30 
DF, 4-72 partition for, 5-10 
DK, 4-72 task-build, 5-9 
DL, 4-73 terminal, 4-49 
DM, 4-73 user-written, 4-33 
DP, 4-74 DSC 
DR, 4-75 task build, 6-13 
DS, 4-76 using to backup target system 
DT, 4-76 disk, 6-19 
DU, 4-77 Dynamic storage region 
DX, 4-78 see Pool 
DY, 4-78 Dynamic storage region (DSR) 
EM, 4-78 see Pool 
GR, 4-79 
LA, 4-79 EAE, 4-13 
LP, 4-80 EIS, 4-14 
LS, 4-82 EOS 
MM, 4-83 breakpoint, 3-8, 4-8 
MS, 4-84 EOX 
MT, 4-84 breakpoint, 3-8, 4-9, 5-6 
MU, 4-84 Error logging 
PP, 4-85 device, 4-33 
PR, 4-85 Error Messages, 8-1 
UD, 4-85 Event flags 
XB, 4-86 group global, 4-38 
XE, 4-86 Executive 
XL, 4-87 commons, 4-27 
XM, 4-87 definition, 1-3 
XP, 4-88 Large (20K), 4-32 
XQ, 4-88 routines 
XU, 4-89 SGTWRD, 4-34 
XW, 4-89 SPTWRD, 4-34 
YH, 4-90 source files disk, 4-9 


Index-—2 


Executive Debugging Tool 
see XDT 

Extended arithmetic element 
See EAE, 4-13 

Extended instruction set 
See EIS 


FCP 
definition, 1-4 
file sharing, 4-26 
option, 4-61 
placement control, 4-26 
support, 4-25 
user-written, 4-62 
FCPLRG, 4-62 
FCPMDL, 4-61 
FCPMIN, 4-61 
FCPSML, 4-61 
FCS 
definition, 1-3 
PLAS resident library, 4-60 
tasks that use, 7-1 
FCSRES 
linking tasks to, 7-4 
File Control Services 
see FCS 
Files-1l ACP 
see FCP 
See FCP, 4-25 
FIS, 4-14 
Floating instruction set 
See FIS 
Floating point processor 
See FP1l 
FORTRAN 
see ISA 
FPll, 4-14 


Get Mapping Context directive, 
4-28. 


Help 
extracting a help file, 6-6, 
6-16 
library, 6-6, 6-16 
HELP.ULB, 6-6, 6-16 
HELPBUILD.CMD, 6-7, 6-17 
Host system 
definition, 1-6 


I/O packets 
pre-allocated, 4-40 
I/O rundown, 4-28 
Indirect command files 
independent, 3-5 
BLDLAINIT.CMD, 3-5 
SGNBLDDRV.CMD, 3-5 
SGNKLAB.CMD, 3-5 
invoking, 3-5 
major, 3-5 
overview, 3-4 
Inhibit MCR 
See MCR, 4-4 
see MCR, 5-4 


INDEX 


Interrupt 
definition, 1-4 
Introduction to RSX-11M, 6-8, 
6-18 
IP1l1 


industrial I/O subsystem, 4-60 


power fail, 4-60 
ISA 
FORTRAN routines, 4-59 


industrial/laboratory libraries, 


4-59 


K-series 

device support, 4-13 
KW11-P 

as system clock, 4-16 
KW11-Y Watchdog timer, 4-16 ° 


Layered products 
installing, 6-12, 6-19 
Line printer 
options, 4-80 


Magnetic tape kit 
copying 
on-line, 2-19 
stand-alone, 2-6 
Map device, 4-24 
Mapped 
baseline system 
bootstrapping, 4-2 
system 
definition, 1-5 
MCR 
creating saved answer file, 
3-11 
inhibit 
execution 
Phase II, 5-4 
PREPGEN, 3-11 
inhibit execution, 4-4 
MCR RUN support, 4-32 
Memory 
cache, 4-17 
management 
PLAS directives, 4-27 
parity support, 4-17 
processor memory size, 4-12 
Multiuser 
protection, 4-29 
Multiuser system 
tailoring, 6-8, 6-18 


NCT 

including support for, 4-37 
Network Command Terminal 

See NCT 


On-line 
definition, 1-6 
formatting (FMT), 4-30 


Partition 


creating with SYSVMR.CMD, 5-14 


Index-3 


INDEX 


Partition (Cont.) 
DRVPAR, 5-10, 5-16 
EXCOM1, 5-15 
EXCOM2, 5-15 
FCPPAR, 5-16 
GEN, 5-12, 5-16, 5-17 
specifying a base address, 
7-4 
PAR14K, 5-18 
SLPPAR 
specifying a base address, 
7-5 
specifying a base addrress, 
5-12 
SPLPAR, 5-13, 5-17, 5-18 
SYSPAR, 5-12, 5-16, 5-17, 5-18 
specifying a base address, 
7-5 
system-controlled, 4-37 
TTPAR, 5-15 
Phase I 
description, 3-1 
example, 4-98 
preparation, 4-2 
sections, 3-2 
Phase II 
Description, 5-1 
description, 3-2 
example, 5-20 
input files 
RSX11M.OLB, 5-1 
RSXBLD.CMD, 5-1 
SGNPARM.CMD, 5-1 
TTDRVBLD.CMD, 5-2 
preparation, 5-2 
sections, 3-2, 5-2 
Phase III 
description, 3~4, 7-1 
example, 7-6 
preparation, 7-2 
PLAS directives 
see Memory 


PMD, 4-63 
PMT 

see Pool 
Pool 


definition, 1-3 
description, 4-44 
device influence, D-5 
monitoring, 4-64 
PMT, 4-64 
size 
calculating, D-~1l 
specifying, 4-44 
task influence, D-1 
Post Mortem Dump 
see PMD, 4-63 
Power fail recovery support, 4-32 
PREPGEN, 3-11 
See also MCR inhibit 
Phase I, 4-4 
Phase II, 5-4 
Processor 
memory size, 4-12 


Processor (Cont.) 

Rotating pattern in data lights, 

4-36 

valid on RSX-11M, 4-11 

with switch register, 4-1l 
Protection 

multiuser, 4-29 
PRT print spooler, 4-63 


QIO 
diagnostic, 4-30 
QIO packets 
pre-allocated, 4-40 
Question 
default response, 3-6 
examples, 3-6 
format, 3-5 
logical order, 3-7 
Queue manager, 4-38 


RA60/80/81 tape kit 2 
copying 
on-line, 2-19 
Record Management Services 
See RMS 
Resource Monitoring Display 
see RMD, 4-63 
RKO06/07 kit 
disk kit 
copying 
on-line, 2-22 
stand-alone, 2-12 
RLO1/02 kit 
disk kit 
copying 
on-line, 2-24 
stand-alone, 2-15 
RM02/03/05/80 tape kit 
copying 
on-line, 2-19 
RMD, 4-63 
RMS 
Installing, 6-9 
RMSINSTAL.CMD, 6-10 
startup command procedures, 
6-11 
using VMR to create partitions, 
5-19 
RP04/05/06 tape kit 
copying 
on-line, 2-19 
RSX11M.OLB 
definition, 5-1 
RSXBLD.CMD 
definition, 5-1 


Saved answer file 

See also Standard Function 
System 

aborted, 3-10 
creating, 3-10 
default name, 4-6 
definition, 3-9 
input, 4-6 
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Saved answer file 
input (Cont.) 

Phase II, 5-5 
naming conventions, 3-10 
output, 4-7 

Phase II, 5-6 
purpose, 3-10 
restrictions, 

Scheduling 
round-robin interval, 4-41 
highest priority, 4-41 
lowest priority, 4-42 
Section 
Executive Options, 4-25 
Host Configuration, 4-23 
Peripheral Options, 4-67 
Setup, 4-3 
System Options, 4-59 
Target Configuration, 4-11 
Send/Receive By Reference 
directive, 4-28 
SGNBLDDRV.CMD, 3-5 
SGNKLAB.CMD, 3-5 
SGNPARM.CMD 
definition, 5-1 
description, 7-2 
question, 5-4 
SGNSTAND.CMD, 3-11 
Shuffler support, 4-37 
Software Performance Monitor 
see SPM 
Space problems 
disk space recovery, 6-3, 6-14 
SPM, 4-65 
Stand-alone 
definition, 1-6 
Stand-Alone Configuration and 

Disk Sizing Program (CNF 
See BRU64K 
See BRUSYS 

Standard Function System, 1-2 
See also Saved answer file 


3-9 


description, 3-11 
options included, 3-12 
purpose, 3-11 
question, 4-7 
restriction, 3-12 
STARTUP.CMD, 6-8, 6-18 
RMS procedures, 6-11 
Subsytems 
IC and IS, 4-93 


Switch register 
question, 4-11 

Symbol 
saved answer, A-1l 

SYSGEN 
Autoconfigure, 3-17 
definition, 3-1 
independent command files, 3-5 
indirect command files, 3-4 
introduction to, l-l 
minimum requirements, 1-1, 
operating environments, 2-3 


4~2 


Index-5 


INDEX 


SYSGEN 


operating environments (Cont.) 
on-line 
RSX-11M host, 2-3 
RSX-11M-PLUS host, 2-4 
VAX-11 RSX host, 2-4 
stand-alone, 2-3 
overview, 1-2 
phase, 3-1 
Phase I, 4-1 
Phase II, 5-1 
Phase III, 7-1 
planning suggestions, 1-1 
PREPGEN, 3-11 
See also MCR inhibit 
Phase I, 4-4 
Phase II, 5-4 
question 
format, 3-5 
Standard Function System, 3-11 
terminology, 1-3 


System 


baseline, 1-5 
directives, 4-38 

host, 1-6 

mapped, 1-5 

multiuser setup, 6-8, 6-18 
naming, 4-65 
on-line, 1-6 
stand-alone, 
target, 1-6 
unmapped, 1-5 
unsaved, 1-6, 


1-6 


6-1 


System image 


See SYSVMR.CMD 


SYSVMR.CMD 


creating partition structure, 
5-14 

creating RMS partitions, 5-19 

description, 3-3 

on mapped systems, 5-14 


on unmapped systems, 5-17 
restriction, 3-4 
VMR 

invoking from on-line host, 


5-18 


Target system 


creating a backup copy, 6-9, 
6-19 

definition, 1-6 

installing layered products in, 
6-12, 6-19 

saving, 6-2 

nonstandard unmapped, 6-13 

transferring to different type 

of disk, 6-5, 6-15 


Task 


building 
description, 6-4 
nonprivileged task, 7-2 


INDEX 


Task (Cont.) Update (Cont.) 
rebuilding user-written, 6-6, command procedure, 2-28 
6-16 errors, 2-34 
termination (TKTN), 4-31 installing, 2-26 
Task loader layered product files, 2-35 
loadable, 4-26 package, 2-27 
nonresident, 4-26 preparations, 2-28 
Terminal driver 
options, 4-49 Vector 
TKTN, 4-31 altering using CNF, 2-5 
TTDRVBLD .CMD data transfer 
definition, 5-2 size of, 4-40 


definition, 1-4 
floating, E-~4 


UIC highest interrupt, 4-17 
setting, 4-2 VMR 
Unmapped system See also SYSVMR.CMD 
definition, 1-5 editing SYSVMR.CMD, 5-14 
question, 4-6 establishing system features, 
Unsaved system 6-9, 6-19 
bootstrap, 6-2 invoking from on-line host, 
nonstandard unmapped, 6-12 5-18 
definition, 1-6 
Update Write-lock 
applying, 2-29 software support, 4-35 
on-line, 2-32 
stand-alone, 2-30 XDT, 4-35 
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Did you find this manual understandable, usable, and well organized? Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 
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Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 
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